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1 INtROOUCttON 

.w id the primary futietldn e£ the Mrctaft Tteiae ^tedidtidn Program 
(ANOPP) te predict airdtaft noide with the best durrently available methods. 
The prediction methdds implemented iA AHOPP are based on re£erenceable meth>- 
ods and data. AS hew methdds and data become available, they are evaluated 
and may be incorporated in AttOPP. 

Although the primary function of ADOPP is accurate noise prediction of 
aircraft operations, several secondary functions provide the framework for 
the prediction capability, ihese Secondary functions include the following: 

1 . Providing alternate prediction methods when available 

2. Providing data for development and evaluation of prediction methods 

3. Providing software that is flexible enough to adapt to future noise 

prediction needs 

4. Providing for extension and revisions of current prediction methods 

5. Providing optimum use Of computer resources 

AiiOPP is documented in the "Aircraft Noise Prediction Program iheoreti*- 
cal Manual" (ref. i). the "ANOPP Programmers' Reference >«nual for the fixec- 
utive System" (ref. 2). and this user's manual. 

the ANOPP Theoretical Manual provides a rigorous description of the 
noise prediction methods implemented in AMOPP. Rguations. diagrams, and 
technical references allow the user to select the methods applicable to the- 
problem. Oata requirements are described carefully and limiting values are 
given for each data item, fivery ANOPP u:ier should have a copy of the 
Theoretical Manual in. addition to this manual. 

The ANOPP Programmers' Reference Manual details the inner workings of 
the ANoPP executive system. Design strategies, development methods, and 
implementation specifics are presented in sufficient detail to facilitate 
program development and maintenance. The ANOPP user can refer to this man- 
ual to add or modify executive system capabilities, to transition to a new 
computer system, or to acquire in-depth knowledge of the executive system. 
■Riis manual also includes a guide to the writer of a new functional module. 

The ANNOP User's Manual provides the instructions needed to solve a 
wide variety of aircraft noise prediction problems, input preparation, 
method selection, data storage, and programming shortcuts are described. 

Ihe introduction of this manual contains brief overviews of the noise pre- 
didtioh problem, the capabilities and advantages of the ANoPP software, and 
the organization of the manual. 


1.1 lifiiae pRfibiCTtoH OVERVIEW 


tn order to pifedldt itio nolad frcnt art airoraft operation it ia 
rtecesaary to locate the aitfcraCt and observer with reapeot to each others 
model the noiao-gerteratirtg mechaniamsi propagate the noise throogh the 
atmosphere to the observer* and calculate the goantity of the noise that is 
observed. The problem of predicting aircraft noise is divided within An6pp 
into these four areas: 

1. Aircraft flight definition 

2. SOOrcd-nOise modeling 

3. Propagation and ground effects 

4. -Received noise calculations 

The At16PP modules corresponding to each area are Shown in figure 1 

The definition of the aircraft flight path is the first task to be 
performed* for this purpose the flight Dynamics Module (fLi) Was created.. 
This module uses lift and drag tables and a model with two degrees of free> 
dom to compute the flight path of the aircraft. It then expresses the out- 
put in a format compatible with the Geometry Module (GEO ) , which calculates 
sOurce-to-obServer geometry. The Geometry Module perforins one or more 
coordinate-system transformations and attempts to reduce the number of times 
the Source noise must be computed. The satisfactory Completion of these 
modules furnishes the propagatiOn>-path information for the noise. 

The selection of the noise source modules reguired to make a prediction 
can only be made after carefully consulting the ANOPP "iheoretical Manual 
(ref. 1) and evaluating the physical hardware that is being modeled. AMoPP 
provides the source prediction modules along with their reguired data tables 
and attempts to validate the user input. It is possible to provide an 
incorrect model* and only familiarity with the prediction methods and the 
hardware can ensure proper usage, for these reasons the user is urged to 
obtain a copy of the anoPP Theoretical Manual and use it as a coit^nioh 
volume to ■ this -manual. 

The source prediction modules all perform Similar functions: receive 

the input data* compute the source noise in the form of normalised unattenu*^ 
ated free^fieid mean-^sguare pressure at a given distance from the source* 
and output the data in a dimensionless form to a data base. The output 
mean*»sguare pressures are a function of freguency, directivity angle* and 
asimuth angle and ate calculated for 1/3-octave bands with center freguen^ 
cies specified by the user. Pure*>tone data* if present* are added to broad- 
band data in the band in which the tone falls. 

Noise data that are computed by the noise source modules are computed 
for a reference distance from the source. To calculate the noise at the 
observer the Propagation Module (PRo) must be used. This module provides 
fot spherical spreading losses* atmospheric attenuation* and ground-surface 
effects in o cd e c -t o . p redict the 1/3-cctaVe spectra at the observet. 
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The AHCfE»P use^ typically requires a slnqla loeasure of rtoise received by 
an observer at a qiVert time. lioisa bevels Modulo (lEV) parfornts the 
necessary inteqral ever frecjusncy to acquire this tiieastire. this module 
taRes the spectral information from the Propagation Module and, throuqh 
application of an appropriate weighting factor* produces an A-weighted sound 
pressure level* a i>-» 0 ighted sound pressure level* a perceived noise level 
(PMbh a tone>corrected perceived nolee level (pelt)* or an overall sound 
pressure level (oaspD* in addition to the noise levels, the user can cal- 
culate the cumulative exposure to noise with the Effective Eoise Module 
(EfP). this module uses the PELT from LBV and produces the effective 
perceived noise level (SPED for each observer for the entire aircraft 
operation. 

The data required for computing the solution to the general problem 
above are: 

1 . Atmospheric properties data 

2* Lifts- and drag-eoefficient tables for the aircraft 

3. Engine performance data for flight-path computation 

4. Engine Variable tables for each noiSe component to be modeled 

5. Observer coordinate data 

6. Specific engine operating parameters 

7. Problem definition and control parameters 

However* AnOpP is capable of producing predictions of aircraft nOiSe with 
alternate input. Easily described flight paths can be entered manually 
without reference to PLi or GEO. Experimental data oan be substituted for 
any noise source. In fact* any module can be replaced by the tables it 
would have generated. To obtain the exact data required for ahy module the 
user is referred to section 4 of this manual and to the description of that 
specific module in the Theoretical Manual (ref. 1). 


1 .2 SOPTWAftE OVERVIEW 

AEOPP emphasizes the needs of the usex in all its phases. Iliis Is 
especially true when considering the design of the AEopp software. Ihe 
AEOPP software is organised to provide the user with a convenient method for 
supplying input data, for selecting between alternate prediction methods, 
for modifying existing methods ,_atid for adding new capabilities. 

Convenient methods for creating and Modifying data are available within 
the AEOPP software. Large blocks of data have been separated from paramet- 
ric data. Parameters May be small vectors or scalars and are maintained by 
name in a user area constantly available to the prediction methods. Larger 
blocks of data are grouped together In an optimum Manner and are accessed by 
two names which define the logical file (called the data unit) and the sub- 
file Within that file (called the data Member). Hie parameter capability 
functions similarly to the poAtAaE EAMelist capability, while the data Unit 
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(data wewbdr) oai?abtllty resemblas dloaeiy the PORtJi^ fU« Input/oatpot. 

In addition# Most of tho lar^s data blooHs nsoded during an ANdPP tun ara 
elthot otoated by the sofWarO ot loaded during the tun from auxiliary stor** 
age from a file provided by the syetem* Ihis unique data management dapa- 
billty is also Useful for atoring user supplied data for problems better 
solved by extended stUdidB. Although thlB overview gives a basio ander<> 
standing ot the data flAir available within ANOPP# ^e full Oapablllties Of 
data management oart only be reoognleed by referring to the appropriate seo> 
tlons of the "AMdPP Programmers* Refarende Manual for the EXedutive System** 
(ref. 2). 

The capability for the user to easily Modify the problem solution to 
fit his needs is another feature of the AMOPP software, users of aNOPP dan 
investigate the noise produced by individual engine components as well as 
the noise produced by an aircraft flyover. Commonly used problem solutions 
are available within AMOPP and Minimise the user's programming task. ftow> 
ever# the user is able to design and optimise a solution for his speoifid 
problem when necessary. This versatility is achieved through the use of a 
Special command language described in section 3. Ihe set of commonly used 
solutions (which are called procedures) is described in detail in section 5. 
This capability permits AMOPP to solve current noise prediction problems and 
also to anticipate problems of the future. 

the concept of a functional module is yet another feature of AMOPP. 

The computer code is divided into pieces called modules according to the 
task the code was meant to perform. Noise computational modules are com>- 
pleteiy separate from each other and from the utility modules which Serve 
themi Thus# new functional modules can be added and old ones modified or 
replaced with relative ease. Moreover# changes In the computer system on 
which ANoPP runs impact only those few utility modules which communicate 
directly with the outside system. This makes ANoPP a very reliable and • 
maintainable tool for noise research. 


1.3— USER'S MANUAL OVERVIEW 

This manual is structured to accommodate the needs of users possessing 
various levels of ANOPP experience, for the novice# sections 1 and 2 docu» 
ment the basic concepts of the ANOPP system, ihe purpose of these sections 
is limited to preeenting overviews of the program# data components#, and 
terminology to the level required by the potential user, i^e user desiring 
a deeper knowledge of the internal ANOPP system should refer to the "Andpp 
P rogrammer's Reference Manual for the Executive System'* (ref. 2). 

section 3 covers AMOPP usage. It documents the capabilities of the 
executive system control statement language# the user's tool for formulating 
and executing ANOPP applications. Ihe sections, are ordered so that control 
statements with capabilities that are functionally related are documented 
together. Extensive examples of single control Statements and control 
statement streams are provided. 

section 4 documents the installed RWoPP functional modules available on 
the system. These are the coded modules that perform specific acoustic^ 
related functions and that are available for user execution during ANOPP 
runs. A brief functional description# input and output documentation# and 
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oHAinftlort rtfH qtvofl foi? Artdh functidn«il woduld. ftof a dntrtllwd dascUpClort 
of tho raotftodoloqy foK" oach raiidUlf*/ th<^ dflof ohould fofnr tfl tho Mrtpf* Ttifto- 
fHtidrtl Marnml (r«f. 1). 

snotlon *> proflottts tlifl AHl^PP oorttfol oUtdrtiortt proCinluro llhfrtry. 
pfoc^«dUto Ifl .1 not of ANOPP oxPoutlvP Hyfltoi# ooiitfol atrttoWftftCi tHrtt poff drift 
a qffdup df fdlatod tanka# Iftcludtrtq tHo (oxocuttmt of orto of iftofd fuftotlortal 
modUldfl. 'ftid UHdf i« diteoufiuldd to udo thd pfooodurd llBrar'y whondvof pob- 
fllttlo to a.iVo tlffld and to n^duoo orfoi H. 

Sectloft 6 doflfiOH tho contonta of tho aHOPP pofmanPht data band, re- 
tain fimotlonal roodulon roqulro aoount lo-rdlatod tablon and 
pormanent data hano contains tho rncoittradnddd data to be uaod with the func- 
tional rtodliloB. 

Appendixes A to ft sUfUJort tho wain sectlortai Appendix A contains a 
qloftsary of ANiiPP terifta and acrortywsj appendix ft contains aft index to the 
eontrol Btatetnentsj appendix c contains techniques for efror diagnostics and 
r^covery» appendix D contains iftforttatlon for the operatind ftystews for 
which ANOPP is avallahle, and apjvndlx R contains a surtflwry of the ANOPP 
functional modules. 
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2 ANOPP COHCBPt*S 


fhts aecClort contains definitions ahd vocabulary neceaaafy to the Uaer 
of the Aircraft Nolae Prediction Program, tt expiaina how the AMDpp execu>' 
tivB ayHtsm la deaignedi how noiae prediction artd data handling roguifementa 
ate Implemented, and how uaera aontrdl program flow* ones uaafa become 
familiar with the baalc oonccpta, they can refer to aoctlorta 3 and 4 for the 
control carda and functional modulca needed to aolvc their problnma. 


2.1 SYSffM DESIGN 

i^e fundamental design requlromenta of the ANOPP system wore defined as 

1 • Flexibility for the addition, replacement, or removal of prediction 
methods 

2, User control for selective and effective use of the Various 
methodologies 

ANOPP meats these requirements by separating all executive functions from 
noise prediction functions, the program is segmented, or modular, in struc- 
ture. All ANoPP executive system control tasks are performed in executive 
modules; all the noise prediction technology Is contained In functional 
modules . Ilie modular structure of ANOPP provides the desired flexibility 
for adding new noise prediction -modules and for replacing or removing out- 
dated ones. 

ANOPP' 8 executive system allows the uaer to formulate and execute 
numerous variations of the available noise prediction applications, without 
as taring a programming Skill or a detailed knowledge of the host operating 
system, the user prepares an inpjt set of anoPP control statements 
(Hollerith cards or card-image records), the user's control statement 
stream determines the processing flow during the ANoPP run. Using various 
control statements, the uaer selects the functional modules and establishes 
access to or creates- the data items required for each functional module's 
execution. 

the ANOPP executive system provides for all interfacing With the host 
computer's external operating system, it initializes the program, edits the 
control statement stream, processes each control statement by calling the 
required executive ahd/or functional module into execution, and performs 
error handling and exit procedures to the host operating system. Ifie execu- 
tive system performs data base management of the magnetic-tape or mass- 
storage external files on which data items identified by the user reside. 

It also performs data storage management within the central memory estab- 
Liahed for the aNopP run. It manages global dynamic storage (gd§) , a perma- 
nent area established Within the program for every ANoPP run; where execu- 
tive system and user tables ate mairttalned throughout the run. it also 
manages local dynamic storage (Lds), the portion of the program's central 
memory left available after a module to be executed has been loaded. LDS is 
used for internal data storage that is required only during execution of the 
currently loaded module. 


OftldlNAU FAGU !S 
OF POOft QUAUITY 


Figure t shows thd lociicsl structufe of ASIDPP during execution# Cen- 
tral memory 1 r divided into four areasi 

1 . f^dcutive syatein root segment 

2. executive or functional modulo overlay 

3. toCal dynamic storage 

4. Global dynamic storago 



(a) igxeeutivd module eitdcutloft* (b) ^notional module execution* 

Figure 1.- anoPp structure* 


ibe executive system root segment contains all utility subprograms that 
are used repeatedly by the executive or fUftctiohal modules. Ihese Include 
system-specific input and output routines# operating system Interfaces# 
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library subroutines, and others, ibe second memory division contains the 
8{>eci£ic module currently being executed. Local dynamic storage, as 
explained above, is that transient part o£ dynamic storage that may be over- 
laid when the next module is loaded. Global dynamic storage is located at 
the end of core memory, with the boundary between GDd and LDS set by the 
user at execution time. 


2.2 FUNCTIONAL MODULfi (PM) 

A functional module (PM) is a logically independent group of subpro- 
grams that perform a specific noise-prediction-related function or a utility 
(data preparation or modification) function. A PM is loaded into central 
memory and executed when the ANOPP executive system processes a user control 
statement requesting its execution. After PM termination, other executive 
and functional modules loaded to process subsequent user control statements 
may occupy the same area of central memory. 

Section 4 of this manual documents the functional modules currently 
Installed on the ANOPP system. Ihe section defines the noise prediction or 
utility capabilities of each PM and also describes the user parameters and 
data base items required as input to the PM or created within and output 
from it. 

The PM internally satisfies its data requirements by referencing alpha- 
numeric aNopP names of data base items and user parameters. These names are 
used within section 4 to identify the items required by the PM. Before the • 
control statement that requests execution of a particular PM, the user 
includes other ANOPP control statements that establish the required named 
data items in the ANOPP run. An item may have been created in a previously 
executed PM in the same run, and therefore is already in the executive sys- 
tem internal tables; thus, no further user control statements may be 
required. The item may be a User parameter or data base item that the user 
must create via control statements. Finally, the item may be a standard 
table that resides on the ANOPP permanent data base. For permanent data 
base items, the user must attach the item via a control statement prior to 
PM execution to establish it in the run. 

ANOPP named data items (data base items and uses parameters), and how 
an executing PM or a user control card specification references them, are 
described in the following subsections. 

The user has the option of substituting alternate items with names 
other than those recommended in section 4 for the PM data. The alternate 
item may have been created by the user within the run, or may have been 
attached by the user from the permanent data base or user-maintained data 
base. When substitute data base items or user parameters are to be used, an 
alternate name feature of the PM executing control statement allows the user 
to identify which known named items are to Ise used to satisfy specific PM 
data requirements. During the PM execution, the identified alternate items 
are used. This alternate name concept applies as well to output data items. 
Ttie user can establish output items under different names than those used 
within and documented as output from the functional module. 
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2.3 DATA BASt: 

2.3.1 Data Base Components 

All data items used within an ANOPP run reside within the ANOPP data 
base with the exception of system and user parameters. The ANOPP data- base 
concept provides a method of storing and retrieving data on sequential and 
random-access devices. In addition, through the ANOPP convention of named 
primary data base components and the capabilities of the ANOPP data base 
manager, the user is relieved of the responsibility for interfacing with the 
host operating system when opening, closing, reading, and writing external 
files. 


The ANOPP data base is a hierarchical structure consisting, from top to 
bottom, of 

1 . Library - A collectif of data units, which resides on a sequential 

file 

2. Data unit - An ANOPP named collection of members, which resides 

alone on a random-access mass-storage file except When the data 
unit has been unloaded onto a sequential library file for group 
storage or tape transfer 

3. Member - An ANOPP neuned collection of records 

4. Record - A collection of elements 

5. Element - A collection of words 

For the user of ANOPP wiio is not involved in programming functional modules 
or executive system routines, the data base concept of words within elements 
is irrelevant. Figure 2 illustrates the basic structure of an ANOPP data 
unit and the relationship between its resident components. 

The ANOPP data base convention of assigning a name to a data unit and 
to each of its members allows easy identification of the specific primary 
data base components required by functional modules and referenced by the 
user throughout the ANOPP run. 

The executive data base manager records the actual mass-storage address 
of each named member on the data unit. This technique results in efficient 
direct accessing of members in the internal system and is the reason that 
data unit resident files are always on random-access mass-storage devices. 


2.3.1 .1 Data Units 

The ANOPP data unit (DU) is a named collection of named members. 
Except for those residing on sequential library files (described in sec- 
tion 2. 3. 1.3). they are equivalent to a random-access file in the external 
host operating system. 


-“W ,, 
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DAtA UNIT 


. M^rDlrec^y - 

and the naine and address o£ each resident iftewbef — ______ 


MEMB ER (Formatted) 

Header - includes the member's ANOPP name, the address of 
e^rof tS records, and a £omat ssscUlcati^ 

ea ch record is composed of the same sequence of data element typ _ 

r ecord 

Data elements as specified by m«nber format 

1 element, 1 ELEMENT- 1 ELEMENT 1 1 ELEMENT^ 


I 


recorb 


Data elements as specified by member format 

I I 


element, ELEMENT- ELEMENT, 


ELEMENT 



MEMBER CCard image) 

Header - includes member's ANOPP name, the address of 

a^recSya nd“ fonaat .pacification indicatin,^.t each 

record has a single 80 -character (card-image) el^^ 



■ 


MEMBER (U nformatted) 

.onsh^ar Header"- includes member's ANOPP name, address of 

S^recor dTand a format specification indicating that all 
its records are unformatted (undefined elements) 


cz. 


RECORD 

unformatted data 


RECORD 


unformatted data 



Figure 2.- ANOPP data unit structure 
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Thrt unit Is the primary ooftf>onont within the AWOPP data base. 

Section 4 documents the data base Item recfulroments of a functlohal module 
by Identlfylnq each item oy a combination of Its data unit nartle and miimber 
name. As previously discussed In section 2.2« the Intefnal references to a 
specific data item within the PM ar-e-also made with this unit (member) com- 
bination. Normally the combination documented In section 4 Is used. How- 
ever, the-«iser can substitute other data unit (member) combinations via the 
alternate name capability of the control statement that exeautes the func- 
tional module. 

The user establishes a data unit In the ANOPP run via control state- 
ments that attach existlnq data units or create new ones. When a data unit 
has been established In the ANOPP run, Its name is recorded In the executive 
system's data unit directory (PUP). No two data units may have the same 
name at the same time In an ANOPP run. 

The executive system maintains a set of Its own data units within every 
ANOPP run. System: data unit XSUNtT is used Internally to satisfy executive 
system storage requirements. System data unit XRUNIT is used internally 
during checkpoint and restart runs. Both units are restricted from user 
reference except to list their contents. The system data unit DA'fA is 
available to the user as a working storage data unit. It may be used to 
create temporary run-life members that will cease to exist upon termination 
of the ANOPP run or to assemble members that will subsequently be copied to 
a new data unit that Is being built within the run. 

Additional user control statements allow the detachment of a previously 
established data unit by removing its entry from the DUO - the archiving of 
a unit which restricts future ANOPP access to read-only processing, the 
unloading of all or some of a data unit's members onto a library file, and 
the printing of an Informative report of the content of all or some of the 
vlata units currently established In the run. 

Hie user's responalhlllty for relating a data unit to Its external file 
Is limited to those units that reside either on files permanently estab- 
lished In the external system or on new files that the user wants to retain. 
In both Oiises, the user must know the name by which the external file la 
referenced on the required external system control cards. Section 2.5.5 
documents this requirement. 

A user may create a new data unit, from members residing on existing 
units and/or new members built using data from within the Input control 
statement stream. If the new unit Is temporary (not to be retained follow- 
ing the ANOPP run), tiie ANOPP system requests a temporary file on the exter- 
nal system. 


2.), 1.2 Members 

An ANOPP member la a named collection of logically related and orga- 
nised records. Fach member resides on a named data unit and must possess a 
name unique to all other members residing on the same unit. Hie memiier la 
the second and last of the named components In the ANOPP data base struc- 
ture, the data unit being the first. Since no two data units may have the 
same name within an ANOPP run at the same time and because members must be 
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uni({uely named within their data unit, any combination of data unit name and 
Member name is also unic}ue Wi'diin an ANOP£> run. 




Ihe unit (member) oombir>-. ■ * ' is used to address a specific data base 
item 

When specified on a user conttol statement 

When referenced within a functional module 

In Section 4, when identified as a functional module's data item 
requirement 

In Section 5, when identified as a control statement procedure's data 
item requirement 

In section 6, when- identified as an installed item (tables and data 
record sets) that is available to the user on the ANOPP permanent 
data base 

When a user has established a data unit in a -run, each named member 
that resides on that unit is automatically known in the run by its unit 
(member) combination. A user control statement or internal functional mod- 
ule reference to the combination results in. access to the specl£iad member. 

User control statements can be used to create new members on new data 
units, the new members may contain combinations of records read directly 
from the user's input control statement stream and records read from any 
other member currently established in the ANOPP run. 

A member consists of one or more records, each conforminq in structure 
to the member's format specification. The AWOPP record is not a named data 
conqponent. ihe user who builds or modifies a multirecord member must be 
aware of the sequential order of the records. Several control statements 
are available to print the record contents and format specification, ■ttie 
AWOPP record is not formatted in the sense of a format conversion as are 
FORTRAH cotlqputer language records, ihe format of an AWoPP record is speci- 
fied for a member and must correspond to one of three general format types: 

1 . iMformatted- records on a member are variable-length streams of data 

with r.u uniform structure (data element content) defined for the 
member. 

2. Card-image records on a member are fixed- length (80-character) 

alphanumeric records, each with only one element corresponding to 
a Hollerith card image. 

3. Formatted records on a member are fixed- or variable-length records 

with their structure defined by a member format specification of 
the sequence of data element types for each record in the member. 







■ c _ ... & 
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In the format specification of a member, the data types of the elements- 
within records are designated by 


I 

integer 


RS 

real single precision 


RD 

real double precision 


CS 

complex single precision 


L 

logical 


Ah 

alphanumeric string of n characters 

Internally, the executive system equates each 
with the number of computer words required to 
value. Member format specification rules axe 

element type specification 
store a corresponding data 
documented in section 3.7. 


There are two types of special purpose data base members, called proce- 
dure members and table members. Any member that does not fall within these 
categories is simply .called a data member. 


2.3.1 .2.1 Procedure members 


A procedure member contains a- set of card-image records that are AtlO^P 
control statements. This set of records is called a secondary input stream. 
A secondary input may be called into execution from within other input 
streams. Procedure members that have been established on the ANOPP perma- 
nent data bade provide specific noise prediction and/or utility functions; 
they are documented in section 5 of this manual. As for all members, the 
user has control statement capabilities to create procedure members. 


2.3.1 .2.2 Table members 


A table member is an unformatted member containing a single record 
referred to as a data table. A data table has an internal format that cor- 
responds to a valid ANOPP data table type structure. Currently only 
type 1 data tables, defined below, are valid. A special set of control 
statements are available to create a table member and to print summary 
reports describing a table's structure and contents. Table members may also 
be copied from one data unit to another via control statements. Table mem- 
bers installed on the AMoPP permanent data base ate documented in section 6. 

h type 1 data table may be output from a functional module or created 
according to a set of description cards supplied by the user. Section 3.7.3 
documents the description cards for the creation process. A type 1 data 
table may have from one to four independent variables. An independent vari- 
able in the table may be integer, real single precision, or real double 
precision. A dependent variable may be Integer, real single precision, real 
double precision, or conplex single precision. The independent variables 
need not be the same type, nor must the type of the dependent variables be 
the same as that of the independent variables. 
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While creating the table, the user specifies the acceptable interpola- 
tion procedures to be used on the table and, for each Independent variable, 
the extrapolation method to be used if an interpolation recjuest is outside 
the range of the independent variable, interpolation and extrapolation 
procedures » ntinber of independent variables, variable types, and data values 
are defined via description cards supplied by the user. 


2.3.1 .3 sequential Library Piles 

Sequential library files are used to group copies of data units on a 
single external file, the library files are used primarily to transfer data 
bases between computer sites, to provide system backup, and to allow group- 
ing of functionally related data units. 

h set of control statements is provided to handle library files, their 
capabilities include the building of a library, by selectively including 
copies of specific data units and members established in the ANOPP run, and 
the reverse process, resulting in the creation of new single data unit 
files. 


2.3.2 Data Base Definition 


An ANOPP data base is defined as a collection of sequential library 
files and data units, the following three subsections present data base 
concepts that are extensions of the above defintion. 


2. 3. 2.1 Permanent Data Base 

the ANOPP permanent data base is the collection of data units and 
library files established, maintained, and installed as part of the ANOPP 
system on the external files of the host computer. 1116 external files, data 
units, and members that comprise this permanent data base are fully docu- 
mented in sections 5 and 6 of this manual. The noise prediction functional 
modules vdiose date requirements are met by components of this data base are 
also identified in section 6. 


2. 3. 2. 2 user's Data Base 

Typically, the user may wish to create acoustic-related table and data 
members that reflect new or experimental noise prediction technology and to 
substitute these items for those recommended to fulfill functional module 
data requirements in ANOPP runs. The ANOPP user's data base is that collec- 
tion of library and data unit files created and maintained by the user on 
the host computer's external files. 

The user is cautioned that external file names, identified to the ANOPP 
executive system as the residence of sequential libraries or data units, 
must begin with alpha followed by six or less characters. 
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Section 2*5.5 ahd appendix o of this manual documenting specific host 
operating system interface requirements assist in establishing and accessing 
the user’s data base. 


2. 3. 2*3 Run-Life Data Base 

The ANOPP run-life data base is defined as all of the data units estab- 
lished in an ANOPP run and therefore currently identified by entries in the 
ANOPP executive system data unit directory (DUD). The terms run-life data 
unit and run-life member are also used in this manual* A run-life unit is 
one currently established in the run; a run-life member resides on a run- 
life unit* As a minimum* the run-life data base consists of the special 
purpose system data unit xsuNtf * In addition* any data unit established via 
user control statements in the current ANOPP run and not yet detached via 
subsequent control statements is part of the run- life data base* Copies of 
data units and members residing on sequential library files are not part of 
the run-life data base* although they may be used aS a data source when 
building a run-life unit* in summation* the run-life data base consists of 
all currently established data units* which reside on an external random- 
access file that is part of the permanent data base* on the user's data 
base* or on a temporary file established internally by the executive system. 


2.4 USER PARAMETERS 

The ANOPP user may create data parameters within a run via specific 
control statements. The user parameter is a named data array of one or more 
elements of the same data type. User parameter elements may be integer* 
real single precision*' real double precision* complex single precision, 
logical* or an alphanumeric string of characters. 

User parameters are used as input to functional modules. Section 4 
identifies the name* purpose* data type* and number of elements of each user 
parameter that a PM requires. The alternate name capability of the FM exe- 
cuting control statement allows the user to substitute ah existing user 
parameter for the one named by the PM. Functional modules may internally 
create new user parameters* or change the value of existing parameters* 

A user parameter 1s established for the duration of the ANOPP run* and 
its name is recorded in the executive system user parameter table* However* 
the user may change the value of* the data type of* or the number of ele- 
ments in an existing user parameter via subsequent control statements* User 
parameter values may be changed to user-supplied values* to the current 
values of a second user parameter* or to values resulting from a specified 
algebraic operation performed on each element of an existing numerical user 
parameter* with other control statement capabilities* the user can list the 
values of all user parameters currently established in the run and test the 
value of a user parameter to determine the subsequent processing flow* 


2*5 THE ANOPP RUN 

An ANOPP run is a single execution of ANOPP* In contrast* the user's 
job submitted to the host computer may involve the execution of one or more 
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AMOPP runs. The structure of coit^uter job decks depends on the operating 
system under which ANOPP is run, as documented in appendix D. Specific 
external control cards request execution of a program (AHOPP) and indicate 
the location of the input card or card-image deck to be read by that program 
(the AtlOPP user*s primary input stream )* 

By setting the value of an executive system initialization parameter, 
the user can specify an edit-only run. This selection limits the ANOPP run 
to the executive system primary edit phase. During this preprocessing 
phase, the control statements submitted, by the user as hid primary input 
stream are examined for correct syntax, in all ANOPP runs, this phase is 
performed; however, if syntax errors occur, the run always terminates after 
the edit phase. 


2.5..t Control Statements (CS) 


Control statements (CS) are the functional directives by which the user 
controls an ANOPP run, lliey are all structured in accordance with general 
control statement specifications (documented in section 3.1 .2) , and each 
possesses a specific format that reflects the functional capabilities it 
provides to the user. An indexed list of all control statements appears in 
appendix B. 

Specific capabilities provided by control statements include 

1 . Establishing the beginning and the end of the primary input stream 

2. Setting the executive system run-control parameters 

3. Calling secondary input streams (procedure members) and transfer- 

ring control to called streams 

4. Selecting print options including the printing of summary informa- 

tion and content of data units, members, tables, and user 
parameters 

5. .Establishing and reestablishing user parameter array values 

6. Establishing conditional processing within the flow of the control 

statement stream, dependent on current user or system parameter 
values including those associated with an error condition 

7. Assigning data units to the run via creation, attachment, or load- 

ing techniques 

8. Terminating a data unit’s current run assignment 

9. Creating procedure, table, and data members on data units by using 

new data provided within the input stream and/or existing data 
residing on existing members 

10, Executing functional modules 
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11. Craating aequantial library files containin g aorte or fill — 

current run-life data base 

1 2_l^tablishing the checkpoint and restaft capability within the run 


2.5.2 Ptimary input Stream 


Trtie primary input streaiti resides in the user's input deck to ANOPP. 
Only through special control statements that roust immediately precede this 
input stream can the user set initialization run controls (including check- 
point and restart) . Only within the primary input stream can the user sub- 
mit new member data directly from input card images. 


2.5 >3 Secondary Input Stream 

A procedure member is a set of control statements previously created on 
a card-image member. A procedure member may be called from within any 
input stream. When a procedure member is called, the executive system first 
edits the control statements on the member and, if no syntax errors are 
found, passes run control to the called secondary input stream. Since 
called members may contain control statements that call other procedure 
members, the user may effect multiple levels of control within his run. 

In the calling control s-tatement, the user can also modify the content 
of control statements in the called member. The technique involves the text 
replacement of specified old CS field values with new CS field values 
ever the old ones appear on control statements in the called member, flie 
replacement takes place before the edit process. Ihe feature allows substi- 
tution of functional modules to be executed or of data items to be used 
within the functional modules executed within the called stream. 


2.5.4 Run-Control Parameters 

Executive system run-control parameters, whose values may be altered by 
the user via specific control statements, are divided luto two classifica- 
tions: initialization parameters and system parameters. 


2.5 .4.1 Initialization Parameters 

The initialization parameters may be assigned new values only through a 
special optional control statement. When used, this special control state- 
ment must immediately precede the user' s primary input stream in his ANOPP 
input deck, ttie specific initialization parameters, and the user consider- 
ations Involved in their value selection, are documented in section 3.1.3. 

The run environment controls established via Initialization parameter 
values include such items as 

1, The selection of an edit-only run 

2. The size of CDS (global dynamic storage) 
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^ 3* T!he maximuM number of entries in the executive data unlt-dlcexitoiyi 

i ' (PUD) 

4. fhe maximum number of entries In the executive table directory 

5. the number of lines per page to be used for all A!JOPt»-?fenerated 

printed output 

6. the maximum number of card Images for new member generation in the 

primary input stream 


2*5.4. 2 System parameters 


The system parameters are those run-control parameter that may be set , 
and reset, via control statements within input streams, the specific system 
^JSeWrs, .M tJ.. consia.«tlon. U»ol«d U theW «.lu. .eUoUon, 

are documented in Section 3e2« 


The run environment controls established via system parameter values 
include such options as 

1 . Printing of each control statement card image during editing phases 

2. Printing of each control statement card image executed during the 

control statement processing 


3. Executive system's subsequent action when a nonfatal 

oeeurs durind the processing of the previous control statement 


4, Accumulation of cost accounting information 


The system parameters that control the control 
and cost accounting listed above may also be set at run initialization. 


2.5.5 External System interface 

The ANOPP system was designed and structured to relieve the 
most responsibility for interface with the host computer operating system, 
particularly in the areas of execution time, data base, and central-memory 
rrsoirfe However, like any other program, 

ted for execution within a job deck comprised of external system control 
cards in addition to the user's ANOPP input deck. 

Depending on the assistance available at the host computer instal- 
lation, the user must to some degree understand and satisfy f f . 

externil system Interface requirements of his ANOPP run. Appendix D identi- 
fies the specific control cards that satisfy these requirements. 


l-'K'*i4w I'Si 

OF POOR QUALITY 

Interfacing the ANOPP run and boat Qpe.r.a.tlaq system requires knowledge 


of 


1 . AWQPP job deck structure - An appendix example is provided. 

2. Job identification and permission cards - Hie appendix identifies 

these cards, but the host computer installation must provide local 
information. 

3. AHOPP job central-memory and run-time requirements - flie appendix 

supplies recommended settings and identifies the control cards 
that establish them. In addition, specific functional module and 
procedure member documentatioh in sections 4 and 5 may recommend 
adjustments to these settings, based on data unit, table, local 
dynamic storage (LOS), global dynamic storage (CDS), and time 
requirements. 

4. AMOPP load sequence - Hie appendix identifies the control card or 

cards required to load and execute AflOPP* 

5. External file control card requirements - Uie appendix identifies 

and provides usage examples of those control cards required to 
assign an existing external file to a job. to drop a file's- 
assignment. and to permanently establish a file created during the 
AttOPP job. Computer site assistance may be required to determine 
any local user file-access password requirements. Hie user must 
determine which files will fulfill the PM and procedure member 
data base requirements of the job. Hiese must be established in 
the run via control statements. Data items on the AMOPP permanent 
data base can be attached by referencing the names listed in sec- 
tion 6. If a substitute data unit (not part of the ANOPP perma- 
nent data base) is to be used, the external file name for that 
data unit must be known. 


2. 5-.fi Checkpoint and Restart 

Noise prediction applications, controlled by the ANOPP system, often 
require execution of multiple functional modules. Each functional module 
processed potentially establishes interim data items requited by other func- 
tional modules that follow in the run. In so doing, the functional module 
may use considerable computer time and produce an erroneous or unwanted 
condition, whose cause is not immediately identified. H> correct the error 
or to adjust input items to produce the desired final result, the user might 
reexecute an entire ANOPP run one or more times. 

The checkpoint and restart features of the ANOPP system provide an 
^alternative to reruns of entire ANOPP applications. Hie user can establish 
/checkpoints within a run where a cycle will be created on an external check- 
point file. Each cycle on the file contains the internal system and user- 
established data that would be required to reestablish the operating envi- 
ronment that existed in the run at the time the checkpoint occurred. 

Multiple checkpoints may be established throughout the user's input 
stream and may be activated or deactivated. Hie user may subsequently 
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restuirt a run at any ona of the ohacHpoints that was active during the lnt~ 
tlal run. New values of run-control parameters may be substituted, and an 
input stream may be inserted for processing before the restart of the origi- 
nal run. Iho restart is than initiated with the execution of the control 
statement that followed a specific checkpoint in the original run's input 
stream. 

The execution of checkpoint runs and restart runs Involves special 
control statements and parameters. Their usage is documented in 
section 3.10. 


3 ANOPP U3AQB 


Thl^ Aftotian (looumAnta tha apaclflc aontrol atAtamanta that allow tha 
uaar to formulAte and axacuta hia noiaa prediction applicationn. Within 
major aubaactiona* titled paraqrapha diacuaa the variety nC functionally 
related proceaalnq oontrola provided by the control atatamanta. Raoh indi- 
vidual control atatamont (C8) la than documented aa to purpoae« apecific 
formoti functional parameter deacr4Fptiona« axamplen, and raatrictiona. 

Where appropriata« a neparata aubaection preaonta uuaqa examplen utilixinq 
combinationa of related control atatamanta* Hie contentn of thia saction 
explain the uao of ANOpp control atatamanta. Any roqulroraant for external 
operatinq system control cards associated with a si'tecific ANOPP control 
statement function is indicated in the documentation of that function. Ihe 
specific oxternal control carda that satisfy these requirements may differ 
amonq operatinq systems and are documented in the appendixes to this manual 
covcrinq external operatinq system to ANOPP interface* the material pre- 
sented in this section is intended to be both a quido to learninq ANOPP and 
a ready reference source for experienced ANOPP users* The potential user 
who does not already possess a basic understandlnq of what the ANOPP system 
is* and how it works* is advised to read section 2 of this manual* Hie 
experienced ANOPP user should find appendix B to thia user's manual helpful* 
It is an alphabetically ordered index of the ANOPP control statements* 

Listed for each control statement is the subsection in section 3 that docu- 
ments it and the titles and sectional locations of usaqe discussions related 
to its functional capabilities. 


3.1 RUN INPUT DECK 
3*1*1 Overview 


Hie specific job-deck structure required by the operatinq system on 
which the user is executing ANOPP will contain the following: 

External control cards identifying the user's job and permission to run 

Pre-ANOPP-run external control cards that assign to the user's job the 
files and devices in the external system required by the ANOPP run* 
including the object code file of the ANOPP program 

External control cards that load and execute the ANOPP program* occur- 
ring for each ANOPP run in the user's job 

Post-ANOPP-run external control cards that* when required* permanently 
establish data base files created in the preceding run* detach files 
or devices no longer required by the user's job* or purge from the 
external system the permanent data base files no longer required 

A run input deck of ANOPP control statements for each execution of the 
ANOPP program within the user's job 

Depending on the host operatinq system* the run input deck may option- 
ally reside on a card-image file Identified on the external control card 
that executed the ANOPP run* Hie ANOPP program requires a user-supplied run 
input deck consisting of card-lmaqe control statements and* where required* 


3-1 



crtrii-lmrtttn Input tirttn. Ilie contont of thla dack controln tho procaaalnq 
HOi|unnco for oxmnitlon of AlJopp oxocutlvo syaf «^m modulen and nolae predlc- 
tloh functional motiuloa (PM’h) durinq tho ANOPp run, and It oatabURheB the 
aHaiqnment of data required by tho FM*«* The u«er’« run Input deck for each 
ANviPP execution coimiattt of one of the followlnq conf iqu rations t 

The primary input stream 

The primary Input stream preceded by rt slnqle ANOpp initialization 
control stvitement 

A slnqle RSTKT OS, Indicatlnq an ANOpp restart run^ 

A slnqh^ RSTRT CS, followed by the primary Input stream^^ 

At the initialization of every run, the ANOPP executive system performs 
a primrary edit phase* Durlnq this phase, each card-lmaqe control statement 
In the user^s primary input stream Is edited for proper format and content* 
Provided edit errors are not found, each CS la rebtillt Into a fotm accept- 
able to the executive processinq phases that will follow. 


3*1*2 Control.-Statioment Format 


F.ich executive control statement has a specific format presented in a 
correspondinq subsection; all control statement formats adhere to the fol- 
lowlnq conventions: 

The OS directive Is a free-form sequence of fields on multiple card 
imaqes, usinq ?ard-imaqe columns 1 to BO* A field is a name or constant 
rei|ulred on the directive, separ*ited from other fields by delimiters* The 
fields may beqln in any column as lonq as the sequence of fields specified 
for a directive is correct* A OS directive Is terminated with the occur- 
rence of an end-of-data ($) character* A CS may be continued across as many 
as five card Im.lqes if required to complete the directive; the end-of-data 
($) character appears only on the last card imaqe* 

A OS field may not be continued (split) across two cards, with these 
exceptions: a complex 2 ^inqlo-pr eels ion- type field, where one of its two 

rtvil slnqle-preclsion constants may he s^^eclfled entirely on one card imaqe 
and where the second sinqle-preclslon constant may be S|ieclfled entirely on 
the folU^lnq card imaqe; and a strinq-ty|x* field, where the character-value 
portion of the field may be split across card imaqes hut the leadlnq nH typo 
Identi f leaf ion portion of the field stieclf Icatlon may not* For examples of 
all the data-type sfv'clf Icationst see table 1 In rection 3*1*2. Comments 
may be included in the columns that follow the occurrence of the end-of- 
data ($) character on a card imaqo. Comments may not be continued across 
card imaqes. However, a card lmat|e on which the $ is the first character to 
occur is treated as a comment t^ard. 


stnicturefi and user considerations required for ANOPP restart runs are 
dofsimented in section 1*10, 
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OWfGiiMAL PAGE tS 
OF POOR QUALITY 


TAm.E U- DATA TYPPH 


nata 

typo 

ANOPP 

type 

cod© 

Control atatoment 
field forma 

t^>ntrol atatonHWt 

field-als© 
limit in 
charactern 

Value 

ranq© 

Control statement 
B|wjcl float Ion 
examples 

Intoqet 

■ 

tnnn* * «n 
(f optional) 

1H 

(aliin excluded) 

t.arqest* (2**3l)«1» 
nmalleati 0 
(absolute values) 

57M607S2 

0 

Real 

ainql© 

prociolon 

RS 

an* 

n*nn 

n*nnE4>n 

n.nnE'^n 

n*nnGn 

nRn 

aR4-n 

nK-n 

(<f optional) 

U 

Larqeat* 10**4322> 
smallest* 10**-243 
(absolute value) 

7* 

♦o*ia 

273*28E^1B 
375*nE-l2 
-1 •33E05 
1P.322 
322E422 
IE- 28 3 

R©al 

doubl© 

praclalon 

RD 

tn*nnDn 

n«nnOfn 

n*nnD-n 

nO+n 

nDn 

nn-n 

(4^ optional) 


tarqest* 10*«^322i 
SOM 1 lest* 10* *-2^3 
(absolute value) 

17*72027 
36245 *l028rM-2S 
-522*3650-02 
-104.322 
200000001 5 
10-293 

Complox 

ainql© 

proclaion* 

C8 

(RS,RS) 

(RS RS) 

nvo real ainqle 
vuluea within 
parentheaea) 

11 

See RS 

(7**1E279) 
(1R2S0 273*28E4^2) 
(-1 *7E02,0.52) 

toqlcal 

t. 

.TRUE* 

•FALSE* 

7 

•TRUE* 

• FALSE* 

•TRUfe. 
• FAt^E* 

Nollorith 

atrinq 

■ 

nNxxx****x 
<xx«**x part may b© 
©put aoroaa cards) 

ns 

1 to n? characters 
(alphanumeric) 

6H1 23456 
1 1HARC0EFGHWK 

Name 

N 

xxxxxxxx 

a 

1 to « characters 
(first character 
alpha) 

JETUNIT 

FANTAW.E 

Alqebraic 

oporator 

AO 

♦ 

(Hunt be followed 
by a blank) 

1 

♦ 

♦ 

toqloal 

operator 

LO 

*xx* 

4 

*F^i* *LE* *t.T* 
•HE* *GE* *«T* 

« « 


ooii|)l<»i( •in<|U-pr»claton (C8) valua la aperlflaii an two R8 valuea anolttaad within a rnqutrml nnt 
of paranthoana and aaparatad by on© or lior© d©ll«lt©r charact©ra (apac© or ooamaK th© P8 fl©ld may b© 
apUt aoroaa card Imaqoa only at th© d©U«lt©r poaltioni l«©«t n©lth©r RH valu© nay b© apllt* 
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The general form at o f a control statement (CS) Is as follows: 
labal^sAame^Dparands $ ecMManta 

label The label is an optional one-to*eight character name tag Which 

will be associated with the CS directive. It is used in 
providing conditional processing flow branching Within the 
control, statement stream via "GOTO label" capabilities of 
some control statements. A label is allowed on any direc > 
tive except AMOPP, RSTRT, and STARTCS. 

# The specification of on a CS format indicates the require- 

ment for a field delimiter. The delimiter must be one or 
more commas or spaces used to separate CS fields. The comma 
and the space are equivalent and are processed identically 
by the execution system. 

csUaae This is the one-to-eight character control-statement name. 

Valid control statement names recognized by the executive 
system are as follows: 


ANOPP 

CONTINUE 

EVALUATE 

param 

TABLE 

ARCHIVE 

CREATE 

EXECUTE 

PROCEED 

TABLtST 

ATTACH 

DATA 

GOTO 

PURGE 

TITLE 

CALL 

DETACH 

IP 

RSTRT 

UNLOAD 

CATALOG 

DROP 

LOAD 

SETSYS 

UPDATE 

CKPNT 

ENDCS 

MEMLIST 

STAftlCS 

UPLIST 


cqgierands These are the operand fields that are required for each of the 

individual control statements. Operand fields are AttOPP 
names, value expressions, and/or keywords. 

An ANOPP name consists of from one to eight alphanumeric char- 
acters. with the first character always alpha* They are 
used where required by the various control statements to 
identify by name a user parameter, system parameter, data 
unit, member, external file, or functional module. 

Value e:q>ressiohs consist of data that conform to the numeri- 
cal constant, logical, and string data types shown in 
table 1 in section 3.1.2* Specification of algebraic or 
logical operations may be required* 

Keywords are used on some control statements to specify the 
selection of an optional CS capability or the source of 
required data. 

Additional conventions used within specific CS format specifications are as 
follows: 

Optional fields are always shown enclosed within a set of [ ) * 

A field specification where the user has a choice of two or more oper- 
and types, one of which must be selected, is always shown within a 
set of ( }. 
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Special delimiter characters are shown where required on control state- 
ment format specifications* These special delimiters include ( ) 

■ / * and j» . 


3*1. 1 Init ial ftun-Envlronment Controls 
3*1 *3*1 Overview 

The user has the capability of assigning values to specific executive 
initialization- parameters and system parameters via a special ANOPP CS* 

When used, this optional control statement must be positioned immediately 
preceding the user*s primary input stream in the run input deck* The ini- 
tialization parameter values remain in effect for- the duration of the runi 
the system parameter values may be subsequently and repeatedly c'nanged via 
SBtSYS control statements within the CS str-eam* The following paragraphs 
define each of the run-environment controls that the user may effect via the 
ANOPP CS capabilities* 

Specifying the length of GPS (global dynamic storage)* - The area of the 
ANOPP program's central-memory field length called CDS is used by the execu- 
tive system throughout the run* Within GDS, the system establishes table 
areas during functional module (FM) execution and establishes storage areas 
used during the run* The default size of GDS is 12000 wrds* In section 4, 
documentation of specific PM’s with the data Units and tables used by that 
PM are identified* The user must determine from this documentation, and 
from the input CS stream, the highest number of units and tables reguired 
concurrently at any one time during the run* (Some FM documentation may 
include a required GDS-size value*) Prom section 4 documentation, and also 
from run eigterience, the user can determine if the need exists for increas- 
ing the size of GDS for specific ANOPP runs*- The user can minimize the GDS 
requirements by dropping the run assignment of data Units and library files 
no longer needed prior to assigning those required later in the run* An 
increcce in GDS size may require a corresponding increase in the external 
control card specification of core memory (field length)* Integer-type 
executive initialization parameter LRNgl control GDS size* A sample 
ANOPP CS user specification would appear as LfiNGL=1400C* Depending on the 
user's run requirements, GDS size may also be decreased* The minimum value 
assignable to LENGL is 3000* 

Specifying the maximum number of executive s ys tem table-directory 
entries *- During functional module execution, ANOPP tables residing on table 
members, or created within the PM, are established within GDS as they are 
needed* When a table is opened for use, it is recorded in an entry of the 
system table directory* if section 4 documentation of an PM indicates that 
the maximum number of tables open simultaneously exceeds a default value 
of 10, the user must increase the value of integer-type initialization 
parameter NAETD* A seunple ANOPP CS user specification would appear as 
NAETD»15. Depending on the user's run requirements, the maximum number of 
table-directory entries may be decreased, thus allowing for better utiliza- 
tion of GDS. The minimum value assignable to NAETD is 1. 

Specifying the maximum number of executive system data-unit-directory 
sntries *- Whenever a data unit is assigned to the user's run via the 
ATTACH CS, CREATE CS, or UNLOAD CS, it is known to the run via its entry in 
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the ANOPP data unit directory (DOD). Prom the section 4 documentation of 
the PM '8 to be executed In his run, from the section 5 documentation of aay 
procedure members the user may eall In his run, and from the user's owh 
control statement stream, the user may determine the maximum- number of data 
units that must be known to his run at any one point In time. Through use 
of the DETACH CS and PURGE CS, the maximum may be kept as small as possible. 
If the number exceeds a default value of 25, the user must Increase the 
value of Integer-type Initialization parameter MAEUD. A sample ANOPP CS 
user specification would appear as NAEUD-30. Depending on the user's run 
requirements, the maximum number of DUD entries may be decreased, ttus 
allowing for better utilization of GDS. The minimum value assignable to 
HAEUD Is 5. The user must remember that In any ANOPP run the minimum run- 
life data base will consist of system data units DATA and XSUNIT, that In a 
checkpoint or restart sun system data unit kRUNiT will also exist, and that 
all three data units require their own DUD entries. 

Sp ecifying the number of lines per page for ANOPP printed output.- A 
page of printed output produced during an ANOPP run normally consists of the 
default value of 48 lines per page, controlled by Initialization parameter 
NLPPM. The first five lines of each page are utilized for the standard 
ANOPP page header, documented within section 3.2.3 covering the TITLE con- 
trol statement, ^e user may change the number of lines per printed page 
via the ANOPP CS. A sample ANOTP user specification would appear as 
NlppM= 40. The minimum value assignable to NLPIW Is 15. 

Sp ecifying a prlmary-edlt-phase-only run. - At Initialization of 
ANOPP t^n, the 'executive system performs a primary edit phase. During this 
phase, each control statement of the user's primary Input stream Is edited 
for correct format and content. The user submitting a new control statement 
stream may wish to limit the run to this editing phase by setting logical 
Initialization parameter NOGO to .TRUE.. The ANQeP_C§_apeclflcation would 
appear as flOGO=*TRUEee 

Spe cifying the maximum number of data cards allowed Ij i the primal^ 
Input stream*- Ihe DATA CS, TABLE CS, and UPDATE CS allow the aser the capa- 
billty of defining the Individual records that will reside on a member. One 
way to input the data Is through the user's primary Input stream. When the 
set of card Images Is Included In the primary Input stream, the user can 
specify the maximum number of card Images allowed through the parameter 
MAXCARDS on the ANOPP CS. If the user does not define MAXCARDS, a default 
value of 10000 is used* 

In addition to the initialization parameters discussed above, the user 
may change the default values of some system parameters via the ANOPP con- 
trol statement. Usage discussions for system parameters are presented In 
section 3.2. Their functional description Is also contained In table 2 
presented In section 3.1 .3.2. 


3. 1.3. 2 ANOPP CS 

Purpose: The ANOPP control statement allows the user to assign values 

to specified executive initialization parameters and system parameters 
during the ANOPP run# 






mmgmm 
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Format t 

patam the name of an executive system parameter or Initialisation 

parameter, subject to change via the ANOtP CS, whose \»alue the 
user wishes to replace (see table 2) 

value the value, of the correct data type, which is to replace the 
default value for the specified parameter 

Example St 

AHOPP J&CMO.TRUE. $ 

ANOPP JLOG«.PAI.Sfi. LENGL=3500 $ 

AMOPP MLPPM=45, NOGOo.TROE., NAE0D»6 $ 

Restrictions: 

The ANOPP CS is valid only as the first CS in the user's run input 

deck. 


The label field ts illegal on the ANOPP control statement. 

Assigned values must be of the correct data type and within the range 
prescribed for the system or initialization parameter. 


OmtGtNAt PA3E IS 

Of POOR QUALITY 


TABLE a.- AHOPP CS IHmALtBATtON AHP SYSTEM PARAMEtEBS 


1 parAinttcir 


Value 


Default 

Name 

Type 

oeacrspsion 

Typv 

Range 

value 

ACCOUNT 

Syetem* 

Controls acconalation of cost- 
accounting data associated with 
each functional modulo or exocu- 
tlvo processor 

ACCOUNT* bTRUSb - accumulate 
accounting data 
ACCOUNT*. FALSE# - do not 
accumulate accounting data 

Logical-. 

.TRUE. 

.FALSE. 

.FALSE. 

CKPNT 

Znitialiaatlon 

Identifies external name of check- 
point file to be generated during 
the run. Its specification also 
results in oystem parameter 
JCKPNT being initialised as 
.TRUE., automatically activating 
checkpoint processing in the run 
(See section 3.10) 

Alphanumeric 
name of 
seven 
characters 
or less 


CPFILE 

JECHO 

System^ 

Controls printing of CS card image 
upon validation in primary edit 
phase (primary input stream 
editing) and secondary edit 
phases (procedure member editing) 

JECHO* .TRUE. - pri-nt CS card 
images 

JECHO* .FALSE. - do not print CS 
card images 

Logical 

•TRUE. 

.FALSE. 

.FALSE. 

JLOG 

System^ 

Controls printing of CS card images 
upon execution in executive 
processing phases 

JLOG* .TRUE. - print CS card 
images 

JLOG*. FALSE. - do not print 
CS card images 

Logical 

.TRUE. 

.FALSE. 

.TRUE. 

LENGL 

initialisation 

Controls sise (number of computer 
words within user's job field 
length) assigned to global 
dynamic storage (GDS) for this 
ANOPP run 

Integer 

:^3000 

12000 

HAXCARDS 

Initialisation 

Controls maximum number of data 
cards allowed in primary input 
stream following an UPDATE^ DATA^ 
or TABLE CS 

Integer 


10000 

NAETD 

Initialisation 

Controls number of table-directory 
entries initially allocated for 
this ANOPP run 

Integer ' 


10 

NAEUD 

Initialisation 

Controls number of data-unit- 
di rectory entries initially 
allocated for this ANOPP run 

Integer 


23 

NLPPM 

initialisation 

Controls number of lines per page 
to be used for ANOPP printed 
output during this run 

Integer 

^18 

48 

NOGO 

Initialisation 

Determines if ANOPP run is to be 
limited to primary edit phase 
execution only 

NOGO* .TRUE. - primary edit 
phase only run 

NOGO* .FALSE. - normal ANOPP run 

Logical 

•TRUE. 

.FALSE* 

.FALSE. 


*Sy»t«« par«i»«Mr v«1uas may also be set via the SBTSY3 CS« 
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3«1»4 Primary Input stream 


3,1 .4.1 —Overview 


Bie primary input stream is the set of CS card images that resides on 
the user's fun input deck, optionally preceded only by a single AHOPP CS or 
RSTRT CS. The first control statement in a primary input stream must be the 
STARTCS control statement. The initiation of a normal ANOPp run always 
begins with- the processing of the STARTCS CS. The last CS in a primary 
input stream must be the ENDCS control statement*. The normal termination of 
a nonrestart AROPP run always occurs with the processing of the ENDCS CS. 
Within the primary input stream, the user establishes the main processing 
control sequence f6r the run. Although control may be passed temporarily to 
a procedure member secondary input stream via a CALL CS, it must always 
return to the primary stream. Only within the primary input stream may the 
user directly input new data for the creation of members via capabilities of 
the DATA CS, TABLE CS, or UPDATE CS. 


3. 1.4. 1.1 STARTCS CS 

Purpose: The STARTCS control statement indicates the beginning of the 

user's primary input stream. 

Format: S5TARTCS $ 

Restrictions : 

STARTCS is valid only when used as the first control statement in the 
primary input stream. A label field is not allowed on the STARTCS. 

A STARTCS CS may optionarlly be preceded by an ANOPP CS in the user's 
input deck. 

3. 1.4. 1.2 ENDCS CS 

Purpose: The ENDCS control statement indicates the end of the ^user’s 

primary input stream and terminates the ANOPP run. Special usage of this 
control statement within ANOPP restart runs is documented in section 3.10. 


Format: (Utami^iaiDCs $ 

label label name 

Examples : 

ENDCS $ 

EOJ ENDCS $ 

Restriction: ENDCS is valid only when used as the last control state 

ment in the primary input stream. 


3-9 


3. 1.4. 2 Btamplea 

A normal ANOPP run would consist of a primary Input stream consisting 
of 


STARTCS $ 

other functional control statements 
BMDCS $ 

The primary Input stream rtay optionally be preceded by an ANOPP CS In 
the user’s Input deck: 

ANOPP JLOGb. FALSE. $ 

STA^TCS $ 

ENDCS $ 

For examples of primary Input streams used for ANOPP restart runs, see 
section 3.10. 


3.2 CHANGEABLE RUN-ENVIRONNENT CONTROLS 
3.2.1 Overview 


The user has the capability to assign values to specific executive 
system parameters via the SETSYS control statement. In addition, the user 
has the capability to establish, via the TITLE CS, a character string value 
that will appear as a title line In the header of each printed output page. 
The system parameters, unlike the Initialization parameters discussed In 
section 3.1.3, may have their values reset repeatedly during the user's 
run. The following Is a discussion of the usage considerations applicable 
to each of the system parameters* 

Control the printing of each CS card Image during executive editing 
phases .*• Prior to executing the first control statement In either a primary 
or secondary Input stream, the system performs an edit phase In which each 
card Image In the stream Is validated for correct format and syntax. At the 
Initiation of an edit phase, the value of logical system parameter JECHO 
controls whether each validated CS card Image Is to be listed In the printed 
output of the ANOPP run. If JECHO Is at default value .FALSE*, the card 
Images are not listed: If JECHO* .TRUE., each card Image, upon edlt-phase 
validation, will be printed. The user desiring that the primary Input 
stream card Images be listed (during the primary edit phase) must set JECHO 
to .TRUE, via an ANOPP CS. (See section 3.1 .3.2*) During a run, the user 
may control the secondary edit phase printing of validated secondary Input 
stream card Images. The SETSYS CS may repeatedly be used to change the 
value of JECHO. 

Control the printing of each CS card Image during executive processing 
phase.- During the processing phase of an ANOPP run, each control statement 
card Image, In either the primary or secondary Input stream, may be printed 
when It Is executed by the executive system* The user has the option of 
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setting logical system parameter JLOG to .FAT^SB* which suspends the printing 
of control statement card images* Since JLOQ is a system parameter, its 
current value may be reset at any time via the SETSYS CS. System parameter 
JLOG may also be set via the ABOPP CS (section 3*1 .3.2), allowing optional 
oontroL-o£~printing the initial card images in the primary input stream. 

Specify the subsequent processing flow within the CS stream following 
the occurrence of nonfatal error. - During the executive system's processing 
of an individual control statement, a "nonfatal error" may occur* The logi- 
cal system parameter JCON controls the seguence of control statement pro- 
cessing within the CS stream following the occurrence of a nonfatal error. 

If JCON is at default value .FALSE., and a nonfatal error occurs, the execu- 
tive processor will search forward in the CS stream, seeking the first/next 
PROCEED CS. If one is encountered, run control resumes with that CS| other- 
wise, the ENDCS will be found and the run will be terminated. However, if 
the value of system parameter JCON is .TRUE* (via a SETSYS CS), and a non- 
fatal error occurs during the processing of a CS, run control will resume 

with the next control statement in ^he CS stream* 

» 

An executing functional module may recognize certain abnormal condi- 
tions and indicate a nonfatal error occurrence to the system* Tteually, a 
printed message will also be generated by the functional module to inform 
the user of what occurred* Section 4, documentation of an installed FM, 
will indicate what situations, if any, will result in a nonfatal error 
occurrence. Ibe user's prior SETSYS CS value specification for parameter 
JCON will determine processing control following PM termination it a non- 
fatal error condition occurred* SETSYS CS specification may appear as 
JCONn.TRUB. or JCON=. FALSE. . System parameter JCON is not subject to 
ANOPP CS value specification. 

Setting the title line in the ANOPP standard page header. - Bach page of 
printed output generated during a run contains the standard ANOPP page 
header* The user has the capability of assigning a character string value 
to appear as the title line of the header via the TITLE C.S. Through 
repeated use, he may change the content of this line during different phases 
of his run* Ihe capability of this CS is documented in section 3*2*3. Also 
presented in section 3.2.3 is a figure which presents the ANOPP standard- 
page-header content. 

Control checkpoint run and restart run processing .- For usage discus- 
sions on system parameters JCKPNT and JRSTRT, see section 3.10. 


3*2*2 SETSYS CS 

Pur pose t The SETSYS control statement allows the user to assign new 
values to specified executive system parameters during an ANOPP run* 


Jannat t Ilabe]^]S8tsys^iiy«p«fdB| ««alattf I . . , .^yif^rtti„«valtte^] $ 
labai label name 

sympdtaa the name of an executive system parameter subject to change via 
the SETSYS CS (see table 3) 

value the value of the correct data type which is to replace the old 
value for the specified system parameter 

Examples t 

SIETSYS JCONa. FALSE. $ 

LABEL SETSYS JLOG-.TRHE., JBCHO.TRUB. $ 

Restriction t Assigned values must be of the correct data type and 
within the range prescribed for the system parameter. 


TABiie sersYS cn rMUMisriBiifi 



■I 


t 


iyata^ 


Value ^ 

oafauit 

pariMfear 

naaa 

Oaaoription 

‘Typr 

funga 

value 

ACCOWIA 

Odntrola accuaulation of ooat«* 
aooountino 4ata aoaooiataiS w&fcti 
aaeti funotional oodula or omou- 
tiva prooaaaor 

ACCoum^.TiiUB • aoouaulata 
aceountina data* 
ACCOUin^i.PALSC. • do not accu« 
auUta aeoountina data 

logical 

•Tsue. 

.PM41S. 

•FALSE* 

JCKPIIT 

oontrola porferMnoa of dafinad 
ohaeHpoint oparationa duirina 
anaeutton of CKatiT C8 

JCKPM^.TRUI* - dafinad ehaok- 
peint oparationa «1U ba 
parferoad dorind axacrution 
of a GKPIIY Ctt 

JOC9llTte«rALSS. - no Oparatien 
will ba parforMd during 
auaeution of a CKPHT C8 

Logical 

•TRUe. 

•PM.se. 

•PALSB. 

(•TRUB* if 
Ot|)Et 
keyword 
praaant on 
AKOPP or 
RSTRT) 

^COM 

Datarainaa the folloaing axaeaHva 
action uHan tha ayataa nonfatal 
arror flag la aat during 
proeaaaing of a control atatcMnt 
or functional iK»dulo 

Logical 

.TRUE* 

.pM.se. 

•FALSE* 


JC0)0>*TRUB« • axaeution will 
continue aith prooaaaing of 
tha next cs 

dCOM*PM«St« • axaeution will 
continua with next PROCBID cs 
aneountarad In tha C8 atraaai 
If none ia founds eha CNDC8 
will notMlly tarninata tha 
hMOFP run 




JBCHO* 

Oontrola printing of CS card iMgas 
upon validation in priMry adit 
phaaa (prlaary input atraaa edit* 
ing) and aacondary adit phaaaa 
(procedure aeabar editing) i note 
that to affect printing of pri* 
mary CS atraaii card lMgaa» JbCMO 
auat ba aat to .TRUB* via an 
XNOPP CS (aaa aaction )«1*3«2) 

Logical 

.TROe. 

.FALSE. 

.PALSe* 


JECtto«*TRUB* - print CS card 
iaagaa 

dBCKO-.rM.se* - do not print 
CS card iMgaa 




4LOtf* 

Oontrola printing of CS card iaagaa 
upon axaeution in tha axaeutiva 
proeaaaing phasaa 

JtOG-.TROB. - print cs card 
iMgaa 

JtOO-.PM.se* * do not print CS 
card iMgaa 

Logical 

.TRUE. 

.PALSe. 

•TRUE. 

JRSniT 

Oontrola action of axaeutiva Mna- 
gar when CKDC8 (aiaulatad if not 
praaant) it encountered in 
Inaartad cs atraaa of a raaurt 
run 

Logical 

.TRUE. 

.FALSE* 

.FALSE* 

(.TRUE* if 
RSTRT CS 
begins run 
input strcaa) 


JRSTRT-.TRUe. - this roatart 
run Will continua with 
execution of tha dafinad. 
chachpointed CS atraaai 
execution will begin with 
the CS following tha last 
CKPNT CS procaaaad in tha 
ehachpoint run 

JRSTRN* PM.se. - this raatart 
run will tarainata after 
execution of tha CNDCS CS 
in tha inaartad input atraaa 





*Par«Mt«r value My alto tm aet via Ute MOFP cs* 
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3.2,3 MTt«e ca 


Purpose I lha TITLE control statement seta the value of the title line 
to bo printed within the ANOPP standard page header. (See flq, 1.) 

Format I 

label label name 

parattiaile the valid AHOPP name of a user parameter (defined via a 

PARAM CS) that contains the title line value, which must 
be a string constant not exceeding 128 characters (16A8) 

string constant the title-line Hollerith string value, not to exceed 

1 28 characters (1 28Hxxxx. . . .x) 

Examples; 

LABBL1 TITLE 9HJST NOISE $ 

TITLE PARAM1 $ 

Restriction ; Hie title value imist not exceed 128 characters and will 
be printed wl^ the left margin justified. 


Line 1 

mm/dd/yy 

Line 2 

Title 

Line 3 

Subtitle 

Line 4 

Label 

Line 5 



ANOPP Lnn/nn/nn PAGEnnnn 

(128 character laaximum) 

(128 character naxlmun)) 

(128 character maxiioun) 
blank 


ANOPP page-header contents Include: 


mm/dd/yy calendar date of ANOPP run 
Lnn/nn/nn current release level of ANOPP system 


nnnn page count Initiated at zero for each run 

Title title-line value last assigned via a 

TITLE CS; default value • spaces 


Subtitle subtitle-line value last assigned from 
within a system or functional module 

Label label-line value last assigned from 

within a system or functional module 

Figure 1.- ANOPP standard-page-header content. 


3 .3 USER PARAMETERS 
3.3.1 Overview 


The user parameter is a named array of one or more elements of the 
same data type. User parameters are established in an ANOPP run via the 


PARAM CS, the EVALUATE C8, or via the execution of a funotionaX module. See 
seotion 2,4 for dlsousslon of the basic ooncepts ooncernlng their use. Once 
established, a user parameter will be known by its assigned name for the 
duration of the run, A value, data type, and numben-of elements of a param- 
eter may be changed repeatedly during the run, l^o system maintains a set 
of internal user parameter tables that record the last assigned value, type, 
and number of elements of each- parameter known in the run. A user parameter 
may be of typo A (Hollerith character string), L (logical), X (integer), RS 
(real single precision), RD (real double precision), or CS (complex sinela 
precision), Ihe user may generate a listing of currently established user 
parameter values -via the UPLZST CS, 

Establishing a user parameter ,- Unless a user parameter is initially 
established internally within a functional module, the first PARAM CS or 
EVALUATE CS processed that references a specific parameter results in its 
entry in the system user parameter tables, the type, and number of array 
elements, is derived from the value specification on the PARAM CS or 
EVALUATE CS. the value specification on a PARAM CS for a user parameter may 
be as follows: 

One or more data constants 

A reference to a second user parameter whose current value is to be 
assigned to the new parameter 

An algebraic operation to be performed against each array element of a 
second numerical- type user parameter, with the individual results of 
the operation becoming the corresponding array elements of the new 
parameter 

A reference to a specified element of a second user parameter whose 
current value will be assigned to the new parameter 

The value specification on an EVALUATE CS for a user parameter may be 
as follows: 

A combination of one or more arithmetic and/or functional operations to 
be performed with various parameters and values, with the result to 
be assigned to the new user parameter cc to a specific element of an 
already established parameter 

A reference to a specified element of a second user para' r whose 

current Value will be assigned to the new parameter or a specific 

element of an already established parameter 

An example of each of these value specification forms is provided in 
sections 3.3.2 and 3,3.3. 

Changing a user parameter ,- A previously established parameter may have 
its value and type changed via a subsequent PARAM CS or EVALUATE CS, or 
during the execution of a functional module, A previously established 
parameter may have its array size changed via a subsequent PARAM CS or 
during the execution of a functional module. 
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OWGINAL 


S/itt« fytnq functtonnl modulo rngutr^montH for user paranwterB *- In 
soctton 4» documfint-ntlon of Instnllod Prt’s Idf^ntlflofl tho noiuo» function* 
and typo of each UBor paramotor ro«iulr«d for a qlvon PM» Onco oatabll«hfld 
In a run* a parainotor In avallahlo by namo from within any functional 
mooulo*— Ibo uaor may croato and Bubatltuto a different UBor parameter name 
for the Btandard one Identified In Boctlon 4 documentation of aFM data 
requirement* Tbe type and array bIsro must he an Bpeclfled*— 

Listing user parameter va-lues *- The UPLIST CS allows the user to gener- 
ate a system user parameter table dump.. The printed dump lists the name* 
type* system internal type code* and value of each user parameter currently 
Known In the run. Section 3.3.4 documents the informative content of this 
dump. 


3.3.2 PARAM CS 


Purpose: The PARAM control Statement establishes a new user parame- 
ter's value array of one or more elements, or it changes the value array of 
an already existing user parameter. A parameter's current data type and 
number of array elements Is determined by the last value assigned It. 


Format: 


( latael^I »«ii|>reasloit| I . . . .piiaae(|-ex|kM8Sioit,,l $ 

where expression may take any of the following forms: 


pMm2 

value 


AUimrical constant 


label label name 


pnane^ 


the name of the user parameter for which a value la 
established or changed 


to be 


pnaiM^ the name of a previously established user parameter 

pnaMej the name of a previously established single-element user parameter 

of Integer type 

value an array of one or more elements of type numerical constant (1* RS* 
RD, or CS), logical constant (L), or string constant (A). Array 
elements must be separated by one or more delimiters (comma or 
space). Examples of each value-type specification are presented 
below. For all variations of a data-type control statement 
specification, see table 1 In section 3.1.2. When the value 
8|ieci f Icatlon Is for a multielement Hollerith string-type 


parameter, each string constant must specify the same character 
field length (jiHxx. • «x) . 

mimerlcal ccnstiuiit a-numerical constant of type i, rs, rd, or cs 

In the first form, the current value of an unsubscripted parameter 
pname 2 will be assigned to user parameter pname.| . if pname 2 has a- sub- 
script, then the value of the specified element from the pname, array will 
be assigned to the user parameter pname^ • If pname^ is the subscript, it 
must be of integer type and contain only one element. Otherwise, the sub- 
script must be an integer constant. Pname 2 must Contain at least the number 
of elements specified in the subscript. 

In the second form, the specified algebraic operation will be performed 
against each element of this parameter's value array, with the result of 
each operation established in the corresponding element of parameter 
pname.'s value array. The type of pname. (I, RS^. RD, or CS) must be the 
same as that of the specified numerical Constant*.^— _ 

When performing an algebraic operation on complex single-precision-type 
(CS) numbers, each CS number is treated as a two-element single-precision 
array (RS, RS) . Ihen, addition, subtraction, multiplication, and division 
of complex numbers will be calculated as follows, with A, B, C, and D each 
being real single-precision numberst 

(A,B)+(C,D) = (A+C,B+D) 

(A,B)-(C,D) = (A-C,B-D) 

(A,B)*(C,D) * ( (AC-^BD) , (AD+BC) ) 

(A,B)/(C,D) = (((AC+BD)/(C**2-fD**2)),((BC-AD)/(C**2+D**2))) 

Examples; 

The following establishes roal double-precis ion- type parameter L 
(1 element) and integer-type parameters G (1 element) and C 0 element): 

PARAM L-I.5D-2, G=1 234, C = 2 $ 

The following establishes string-constant-type user parameter KEYS 
(3 elements): 

LABEL1 PARAM KEYS=4HPAN 4HJET 4HPR0P $ 

The following establishes logical parameter RESULTS (2 elements): 

PARAM RESUiiTS».TRUE. .FALSE. $ 

The following establishes integer-type parameter NUMBS (2 elements) and 
real double-precision-type parameter STATS (2 elements): 

PARAM NUMBS=3476 5962, STATS® 17. 6 7D2 7 -1.0+194 $ 

The following establishes complex single-precision-type parameter 
AGROUP (2 elements): 

PARAM AGROUP=(7.,177E+17) (265.1 7E+2 -1 .75) $ 
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The following, establishes real double-precision-type parameter T by 
using an algebraic operation baaed on the current value of parameter L> 
establishes integer-type parameter A with- the value of current parameter G> 
and establishes real double-precision parameter B based on the current value 
of parameter T (note that the add operator + is followed by spaces) : 

PARAM T»L*1 7. 620-07, A»G, B»T + 2.0D00 $ 

The following assigns the third element of parameter KEYS to parameter 
E and the Cth element of parameter KEYS to parameter D: 

PARAM E=>KEYS(3) , D=»KKYS(C) $ 

Restrictions: 

The numerical constant used in a PARAM CS specified algebraic operation 
must be of the same numerical i-ype as the specified user parameter (pname 2 > 
used in that operation. 

The operators + or - must be followed by a blank. 

Each value specified for a multielement user— parameter array must be of 
the same type. 

Each value specified for a multielement Hollerith string parameter mast 
be of -the same character length (jtHxx, ,,K), 

For a subscripced parameter name, that parameter must contain at least 
the number of elements specified within the parentheses. If the subscript 
(value inside the parentheses) is a parameter name, it must be of integer 
type and contain only one element. 


3,3,3 EVALUATE CS 

Purpose: The EVALUATE CS establishes a new user parameter of one ele- 

ment or changes the value of an existing user parameter element. 

Format : £label^ 8VAL0ATB^araiB-e:q^_$ 

where param-exp may take any of the following forms: 


pnandi > ei^reasioHtt 


label label name 


pnabei 


the name of the user parameter for which a value is to be 
established or changed. The value assigned to pname^ is 
the result of the evaluated expression. The t<^ assigned to 
pname^ is the type associated with the expression. 
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9 iuaw, the name of a prevloualy established user parameter whose specified 
element will be changed to the result of the evaluated expres- 
sion. If pnaroe. Is the subscript, It must be of Integer type 
and contain only one element. Otherwise, the subscript must be 
an Integer constant. Pname, must contain at least the number 
of elements specified In the subscript, the type associated with 
the expression must match the type associated with pnamej. 

pnaiMj the name of a. previously established single-element user parameter 
of Integer type 

6^resei<xi a sequence of constants, user parameters, subscripted user 

parameters, and function references separated by operators 
and parentheses 

The arithmetic operators are as follows: 
addition 

- subtraction 

* multiplication 

/ division 

exponentiation 

The following functions are available: 


Name 

Definition 

Number of 
arguments 

Type of 
arguments 

Example 

ABS 

|x| 

1 

Any type 

Y=ABS(X) 

ANTILOG 

10* 

1 

I,RS,RD 

Y»ANTIL0G(X) 

COS 

cos(X) 

1 

Any type 

Y=C0S(X) with 
X in deg 

INT 

Express argument as 
integer 

1 

Any type 

Y=*INT(X) 

LOG 

log^Q(X) where 
X > 0 

1 

I,RS,RD 

Y=LOG(X) 

REAL 

Express argument 
as real 

1 

Any type 

Y»REAL(X) 

SIN 

sln(X) 

1 

Any type 

Y-SIN(X) with 
X In deg 

SQRT 

{X Where X > 0 

1 

Any type 

Y=SQRT(X) 

TAN 

sln(X) /cos(X) 

1 

Any type 

Y»TAN(X) with 
X in deg 











Ml operations must be specified explicitly. For example, to 
two variables A and B, the expression A*B must be used. Thus, 
or A.B will result In a syntax error with the exception of AB which Is 
treated as a paframeter naihs* 

An ea^resslon is comprised of subexpressions. In the example 
A/B - C*D**E 

the following are subexpressions: 


(1) 

A/B 


(2) 



(3) 

C* tempi 

(where temp^ * D**E) 

(4) 

tempj - temp2 

(Where tertpj =• C*(D**E) and tempj » A/B) 


The sequence In which an ej 5 >resslon is evaluated Is governed by the 
following rules which are listed In descending precedence: 

(1) Subexpressions delimited by parentheses are evaluated, beginning 

with the innermost subexpressions. 

(2) subexpressions defined by arithmetic operators are evaluated 

according to the following precedence hierarchy:. 

** exponentiation 

/ * division or multiplication 

+• - addition or subtraction 

(3) subexpressions containing operators of equal precedence (+ and - 

or * and /) are evaluated from left to right. 

(4) Subexpressions containing the exponentiation operator (**) are 

evaluated from right to left. 

In exponentiation, the following types of base and exponent are 
permitted: 


Base 

Exponent 

Double precision 

Integer 

Integer, real, and double precision 
Integer, real, and double precision 
Integer 


The exponentiation is evaluated from right to left. The expression A**B**C 
is evaluated as (A**(B**0). 
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y( 1 


(CS RD evaluated at the highest type 

neLi^tiL L?S Si constant in that subexpression. In expo- 

nentiation both the base and eiqoonent are converted to the highest tvoe in 
tte su^xpression with the exception of a complex base. For TcoLleTbase 
any nonintegor-type ej^onent is converted to an integer type. SI tyL of 
the expression is the type associated with the last subexpwssion. evISatld. 

Examples I 


Given the following parameter values, the expression to the left of the 

inL evaluate CS is evaluated and the result, 43.24, is aloxed 

in the user parameter table (OPT) under parameter X: 


PARAM EAD»16.3, BC*5.3, CDs. 96 $ 

PARAM DBS, 3, EP«2.0, B»3 $ 

EVALUATE X = (BAD - BC)*P + (CD/DE) **EP $ 

The following results in the parameter z taking the value 3.S in the 


evaluate Z = SIN(30.0) + RBAL(3) $ 


^ parameter values, the following operations are per- 
then is added to the negative value of Z. The result, 6.5, is stored as the 


PARAM YalO.O, 3.9, 8.2, 1=2 $ 

EVALUATE Y(l) a -2 + INT(SQRT(100.0) ) $ 

Restrictions} 


followed by a blank. For a subscripted 

th, tlUt only 


Each left parenthesis must have a corresponding right parenthesis. 


wifh Ih® associated with the expression must match the type associated 
subscripted parameter. 






P » . fpose > Ae UPLlST control statement will produce a printed liat of 
“ryntl, wlthtn th. Low run. 

iSow ““•'** •»P'« -tot* type, lnt.tn.l 

th. .r??T ““ el'"""' l» 
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Pormatt $ 

Lab«i label name 
Bxamblet 


The following control statement 


ORlGINAl. PAGE 19 
OF POOR QUALiTY 


LABEL1 UPLXST $ 

if executed when the user parameters established in a run were those created 
by the PARAM CS examples and EVALUATE CS examples presented in the two pre- 
vious sections, would produce the following listing: 


aSEtt-PAItMIETEt(-TAia.S DtMP 


NAME 

TYPE® 

TYPE 

CODE 

ELEMEET 

VALUE 

AGftOUP 

CS 

4 

( 

1) 

.70000000000000E<i-01 .1 7700000000000E4-20 




( 

2) 

e2651 TOOOOOOOOOEf OS - *1 7500000000000Ef 01 

A 

I 

1 

( 

1) 

1234 

B 

RD 

3 

( 

1) 

.2000000026429999999999999999904-01 

BAD 

RS 

2 

( 

1) 

*16300000000000Bf02 

BC 

RS 

2 

( 

1) 

.5 3000000000000E4-0 1 

C 

I 

1 

( 

1) 

2 

CD 

RS 

2 

( 

1) 

.96000000000000E4-00 

D 

A 

-4 

( 

1) 

JET 

DE 

RS 

2 

( 

1) 

. 30000000000000E4-00 

E 

A 

-4 

( 

1) 

PROF 

EF 

RS 

2 

( 

1) 

e20000000000000E^01 

P 

1 

1 

( 

1) 

3 

G 

I 

1 

( 

1) 

1234 

X 

X 

1 

( 

1) 

2 

KEYS 

A 

•4 

( 

1) 

PAR 




( 

2) 

JET 




( 

3) 

PROP 

L 

RD 

3 

( 

1) 

.149999999999999999999999999990-01 

NUMBS 

X 

1 

( 

1) 

3476 




( 

2) 

5962 

RESULTS 

L 

6 

( 

1) 

T 




( 

2) 

F 

STATS 

RD 

3 

( 

1) 

. 1 7669999999999999999999999998Df 29 




( 

2) 

- .9999999999999999999999999997541 94 

t 

RD 

3 

( 

1) 

.264299999999999999999999999890-07 

X 

RS 

2 

( 

1) 

.43240000000000&t-02 

Y 

RS 

2 

( 

1) 

.1 OOOOOOOOOOOOOEf 02 




( 

2) 

.650000000000008401 




< 

3) 

.8200000000000081-01 

Z 

RS 

2 

( 

1) 

.350000000000008401 


*TYPE CODE is an intager internal-system-type coda. Of Intarast to tha axtarnal AEOPP 
uaar is tha TYPE CODE tor type A (Holerlth string), axorassed as a negative n value, where 
n is the unifora character length of tha string for el aants of tha user parameter array. 


Restrictions: None. 





3.4 FUNCTIONAL MODULE (PM) EXECUTION 


3.4.1 O^^rvievr 


A functional module (FM) is a grou|> of oubprograms within the ANOPP 
system that perform a specific noise prediction or utility>type function. 

The ANOFp concepts applicable to PM's are presented in section 2.2.- • 

Section 4 of this manual contains subsections « each of which documents 
a specific module available for- user execution via an EXECUTE CS. ihe sub- 
section identifies the FM by ANOPP name» presents a purpose and functional 
description, and describes each of the user parameters and run-life data 
base units and members required for its execution. Also documented are the 
FM characteristics relevant to run environment. 

Satisfying PM user parameter requirements. - In the section 4 documen- 
tation of each functional module (FM), each required user parameter is iden- 
tified by its FM internally known name and is documented as to its func- 
' tional usage, data type, and array size (number of elements). The user 
parameter may be one of the followingi a required input item; an optional 
input item that, if not currently established in the run at FM execution 
time, will be established by the FM using documented "default" values; or an 
output item always established within the FM. 

Any user pareuneters that are required as input to an FM must be estab- 
lished in the run prior to the FM execution. Unless created by a prior 
execution of another FM within the saune run, the user must establish the 
required parameter via. the PARAM CS or EVALUATE CS. The type and- array size 
of the user parameter must match those documented for the FM requirement. 

If the name under which a user parameter is established is the same as 
the FM internal name, that parameter will be automatically accessible within 
the FM during its execution. However, if the parameter is established under 
a different name, the alternate name feature of the EXECUTE CS must be used. 
This capability establishes the required internal FM association of the name 
of an alternate user parameter candidate with the name by which the parame- 
ter is known within the FM. 

In the same way, the user may specify that a parameter output by a FM 
be established under an alternate name instead of the documented FM internal 
name. Once established within a FM, a user parameter is subject to the same 
accessing rules as one created via a PARAM CS or EVALUATE CS; in either 
case, the parameter will be known by its single assigned name for the dura- 
tion of the run. Section 3.4.3 gives examples of CS streams satisfying PM 
user parameter requirements. 

Satisfying the run-life data-base requirements of a FM. - Section 4 
documentation Identifies each run-life data base requirement of a PM. A 
table member or data member is documented and known within the FM by the 
combination of its resident data unit name and member name. This applies to 
both FM input and FM output data base items. Section 6 of the manual docu- 
ments all data items installed on the ANOPP permanent data base by using the 
same naming convention as described previously. Tables in section 6 indi- 
cate which permanent data base items satisfy data requirements for specific 
PM*s; for a primary candidate identified in the tables, the data unit name 
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(member name) usually matohee the name combination known within the PM. If 
a data unit Is currently established within a run via a prior CrbaI^B CS, 
Al^hCH CS. or IiOAd CS. and the names of the unit and one of -Its members 
match the name combination documented as a data requirement within a func- 
tional module to be executed, that data Item Is automatically accessible 
from within the PM, if the user decides to satisfy a PM data requirement 
using an alternate Item, the alternate-name capability of the BX^UTB CS 
must be used. 

Por example, suppose a PM has a data requirement documented as 
UMlTKMEMbeRI), If the user's alternate candidate existed on the same unit, 
but as RHOTAB., the EXBCUTB CS alternate name specification Would Include 
MBMBBRIaRHOtAB. However, If the alternate candidate resided on unit JETDAT, 
but had the same member name as the documented PM requirement (MEMBBR1), 
then the EXECUTE CS specification would Include UNIT1>JETDAT. I'lnally, If 
both the unit and member nan»s of the alternate Item were different from the 
documented names, the alternate-name specification could Include 
UlttTI -JETDAT, MEMBER1 -RHOTAB . 

Because of this convention for Identifying a rurt-llfe data Item by the 
combination of Its resident unit and member names, and because two data 
units of the same name cannot be currently known within the run at the same 
time, the user must be cautious In his specification of alternate names. 


3.4.2 BCECUTB CS 


Purpose : The EXECUTE control statement calls a specified functional 

module (PM) Into execution and allows the user to Identify alternate data 
Items to be used In satisfying specific data requirements of the functional 
module. 

Pormat : 

Uabel^l iatBCtJT^f iiiiaiM^tref naae^ -altname^ • ••• 0 tefnameg|-alttubie||l $ 
label label name 

fouiame the name of a functional module to be executed. A list of func- 
tional modules Including a brief description la given In 
appendix E. 

refnaae the name known within the functional module for a required data 

unit, data member, table member, or user parameter, it Is also 
the name by which the data Item Is Identified In the section 4 
documentation of the PM's data requirements. 

altname the altname name corresponding to the PM known ref name. The 

altname Is the name of a data unit, data member, table member, 
or user parameter to be used In satisfying the requirement for 
a data Item known within the PM by the refname. 


3-24 


Bxaropleai 

LI EXECU1?E JET UNIT1 "MYONIT, &»D $ 

EXECUTE PROP $ 

Restriotionat 

The fmname must be a functional module currently installed on the AEOPP 
system. 

User-supplied data items must be of the type and format specified for 
the FM application. 

3.4.3 Examples 

The following examples illustrate typical control statements required 
to satisfy FM data requirements. Functional documentation of the various 
control statements used are found in other subsections of this manual. 

Example It The FM JfiTI is to be executed. It r^quiresa logical user 
parameter JSELECT, a real single-precision user parameter 
elements, and data unit JETUNIT on which reside members TABI, TAB2, DMEMI, 
and DMEM2. No substitute data items are to be used; once established in the 
run, all required items will be accessible by the FM. 

STARTCS $ 

e 

ATTACH JETUNIT/F1LE29/ $ CCX4MENT - ESTABLISH JETUNIT IN RUN 

PARAM JSELECT=.TRUE., NSPEED-1 .33E05 -0.52 19.7$ 

EXECUTE JET1 $ 

« 

e 

ENDCS $ 

Exa mple 2 t Execute FM MACH8. Build a required data member identified 
in FM documentation as UNIT1 (STATJ) via the CREATE CS and 
tional module MACHS creates a logical user parameter ^°°““®"J®f ®® 

Because the user has already created a parameter named ^® 

run for a different purpose, an alternate name specification is used to 
cause the FM-created user parameter to be called MSRESULT* 

STARTCS $ 

CREATE UNIT1 $ 

UPDATE NEWU-UNIT1 SOURCE** $ * n * 

-ADDR 0LDM»*, NEWM»STA1VJ FORMAT=1 1H2I,RS,RD,L$ MNR=2 $ 

1757 294372 2Ef01 3D-01 .FALSE. $ 

297 87536 375.1 5E-1 2 15.81D19 .TRUE. $ 

END* $ 

EXECUTE MACHS RESULT=MSRESOLT $ 


jkiU, J ' - 




3,5 RUM-LIPE DATA UNITS 


Hie run-life data units are those units known within an ANOPP run at 
any one point in tlmei this concept is documented in section 2.3.2 ,3. Bach 
run-life data unit is currently known within the system data unit directory 
(DUD) via the processing of a CREATE CS, ATTACH c&« or LOAD CS. A data unit 
is removed from the run-life data base (and its entry from the DUD) via the 
processing of a DETACH CS or PURGE CS, Informative reports about the data 
format and contents of any or all cun-life data units or members are pro- 
vided via the features of the CATALOG CS, MQ4LIST CS, or TABLIST CS, A 
current run-life data unit may be assigned a read-only status, prohibiting 
further output to the unit even in subsequent runs, via the ARCHIVE CS, The 
system units DATA, XSUNIT, and XRUNIT (restart runs only) are also run-life 
data units. 


3,5,1 Assignment 

The CREATE CS, ATTACH CS, and LOAD CS provide user capabilities to 
establish the run assignment of a data unit(s). Hie DETACH CS and PURGE CS 
provide the capability to terminate the run assignment of a data unit. The 
LOAD CS establishes the assignment of a sequential library file and, in 
addition, establishes new run-life data units using data copied from the 
library file. Section 3,6 documents llbrary-f lie-related run assignments* 

Assignment of an existing data unit, residing on an external random- 
access file, is accomplished via the ATTACH CS. That data unit must have 
been either of the following: previously assigned to the run, and then 

subsequently deasslgned from the run via a DETACH CS (freeing its DUD 
entry): or built during an earlier ANOPP run, and residing on an external 
file currently assigned to the user's job. If the data unit was created 
during a previous ANOPP execution, the permanent file on which it resides 
must be made available to this job via external control cards. 

Provided that an existing data unit has not been previously ARCHIVE'd 
(read-only status), the user may rebuild its data content (members) via 
UPDATE CS capabilities. When an existing data unit, alreadv resident on a 
permanent file, is to he rebuilt, additional external control cards may be 
required to expand the file. 

Assignment of a new data unit to be built during the run is performed 
via the CREATE CS, Hie user may optionally specify an external file name of 
the random-access file, on which the new unit will reside, if he Intends to 
establish the file in the host computer's permanent file system (via exter- 
nal control cards) . Once assigned within the run, the new data unit is 
available for the generation of its members via the TABLE CS and UPDATE CS, 

Dropping the assignment of a run-life data unit 1s performed via the 
DETACH CS or PURGE CS, Roth control statements remove the specified cur- 
rently assigned data unit's entry in the data unit directory (DUD), thus 
ending the unit's run assignment. Following a unit deassiqnment via the 
DETACH CS, the user may still access the data unit via a subsequent 
ATTACH CS: this reassignment may occur either in the same run or in a second 
ANOPP run within the user's job. However, the PURGE CS, besides terminating 
the run assignment of an ANOPP data unit, also terminates the job assignment 
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of the external aystem data unlt’a realdenee file to the uaer'a job» TSie 
<*i PURGE'd unit cannot be reaccesaed In the name ANOPP run* It may not be 

' acceaaed In a aubaequent ANOPP run In the aame job, unleaa an external con- 

trol card la proceaaed that reeatabllahea the external ayatem'a job aaalqn- 
ment of the data unlt'a flle^ prior to Initiation of the aubaequent ANOPP 

run* 


3.5.1 *1 ATTACH CS 

Purpose: The ATTACH control statement establlshos one or more prevl-^^ 

ously crated data units In an ANOPP run via entries In the aystem data unit 
directory (DUD). Bach data unit must have previously been created on an 
external mass-storage file currently assigned to the job In the external 
system. 

Format : ATVACH^ii| /efn, / ( . . .^ttha/ef $ 


• label label name 

dun the name of the data unit to b« established In the ANOPP run 

/efft/ the name of the external mass-storage file, currently assigned to 

the user's job, on which data unit dun resides 

Examples: 

APP ATTACH JET01/P1LBJ/, FAN01 /PIIjEP/ $ 

ATTACH PR0PU1/EFN/ $ 


Restrictions : 

Each data unit naane (dun) must be unique with respect to all other data 
unit names currently known In the run. 

Each external file name (efn) must be unique with respect to all other 
efn's currently known In the run. 

Each data unit (dun) specified must have previously appeared on a 
DETACH CS. 

If the data unit was created In a previous ANOPP job, the external file 
(efn) It resides on must be currently assigned to this job via external 
control cards. 


3.5.1 .2 CREATE CS 

Purpose: The CREATE control statement Initially defines In the ANOPP 

run an ' fe y data unit, to reside on a random-access mass-storage device, 
and makes It available for subsequently generated table, data, and procedure 

members. 
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Forma t t 

label label name 

dull the name of the new data unit to be entered In the system data unit 

directory whoso members are to be generated during the run 

/ofit/ the name of the external mass-storage file, assigned to the job In 
the external system, on which the corresponding dun will reside. 
If efn is omitted, a scratch (temporal/) file will be established 
by the ANOPP system. 

Examples: 

LABEL1 create UN1T1 , UN1T2/EPN2/, JETUN1 /JETPILE/ $ 

CREATE J0BF1LE1, J0BPILB2 $ 

Restrlctlona : 

The dun and efn cannot, respectively, be the same as any other dun and 
efn that are either currently known to the ANOPP run (entered In the data 
unit directory) or appear on the same CREATE CS. 

Any data that currently reside on external file efn will be destroyed 
during the creation of new data unit dun, even If the old data were on an 
ARCHIVED ANOPP data unit. 

Note: Reference to a unit that has not been defined by a CREATE CS during 

an ANdPP run will cause the unit to be dynamically created on a scratch 
file. 


3. 5. 1,3 DETACH CS 

Purpose: The DETACH control statement removes a data unit from the 

run-life data base. Unless the data unit resides on a scratch (temporary) 
file. It may be assigned to the current or a future ANOPP run via an ATTACH 
control statement. 

Format: 

[label^)DETACt!^un^(...^tt,j] $ 
label label name 

dun name of the data unit, known to the ANOPP run, that is to be 

detached 

Example: 

LI DETACH PR0PU1, JETU1 $ 

DETACH AIRPRTS $ 

Restriction: Bach data unit named must be currently known in the ANOPP 

run (via an entry In the system data unit directory). 
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3. 5, 1,4 PURGE CS 


Puyposei Hie PURGE oontifol. etAtenient removes a dsts unit from the run® 
life date base) in addition, the external file on vfhieh the unit resides 
will no longer be assigned to the user's job in the external system. 

Porniat i [labol^lPOEGB^n^I $ 

label label name 

dun name of a data unit whose curtent run and job assignment la to be 
terminated 

Example : 

LABBL1 PURGE DU1 , DU2, DU3 $ 

PURGE JBTU1 $ 

Restriction : If the data unit is to be re-ATTACH'ed in the same job, 

or the external file on which the dun resides is to be made permanent via 
external control cards that follow the ANOPP run (in the user's job deck), 
the DETACH CS should be used Instead of the PURGE CS. 


3,5,2 List Options 

The user is provided the CATALOG CS, MEMLIST CS, and TABLIST CS, each 
designed to produce reports on the structure and data content of his run- 
life data units and their members. In addition, the UPDATE CS (documented 
in section 3,7,4) provides optional reports on the new members it generates. 

Producing data-unit-level reports via the capabilities of the 
CATALOG CS, - The user may produce a CATALOG report on specifically named 
data units, or, optionally, on all of the data units currently known in the 
run-life data base (having an entry in the data unit directory), tt.e user 
may select either the SUMMARY or the PULL report to be produced for each of 
the data units indicated on the CATALOG CS. The S'JMMARY CATALOG report 
presents the name of the data unit, the name of its residence external file, 
and the name of each of its resident members. The PULL CATALOG report pre- 
sents the above summary information and, in addition, the following informa- 
tion about each member: the current maximum number of records, the member 

(record) format specification, the maximum record length, and the date and 
time of member creation. 

Producing member-level reports via the capabilities of the MEMLlSt CS .- 
Hie user may produce a MEMLIST report for any member residing on a run-life 
data unit. The user may select either the SIWMARY or PULL report to be 
produced for each member specified on the MEMLIST CS, The SUMMARY MEMLIST 
report includes, for each specified member, all of the data produced by a 
PULL CATALOG report, (See the preceding usage discussion.) Hie PULL 
MEMLIST report contains the summary information for each specified member, 
plus the data values of some (specified) o all of each member's records. 
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Pruducintj tiihlo-roorobor lovol rapo rtw via the capabtUttwH of the 
^ABI.IST CS,« The u«»»r ir..iy proiiuoo a TABLtaT report on nny tnblo moillbar 
rnHldlmi on n run-llf« datn jnlt. fho user may aoloct olther tho SUMMARY 
or PULL rajxjrt to be produced for each table momber specified ort the 
TABLIST CS. The SUMMARY TABLIST report Includes for each specified table 
membt^r all of tho data produced by a PULL CATALOG report. In addition. It 
produces the followlnq information on resident data tablet the number of 
independent variables, the table length in computer Words, and the allowable 
Interpolation procedures defined at its creation. The PULL fABLlST report 
includes, in addition to the <ibove summary data, specific information about 
the variables defined for each table. For each variable, the type code, 
number of table values, and the actual assigned values are listed, in 
addition, for each Independent variable, any defined extrapolation 
procedures are identified. 


3. 5. 2.1 CATALOG CS 


Purpose? The CATALOG eontrol statement produces printed summary infor- 
mation about named data units or. optionally, about all data units known to 
the ANOPP run. In addition, an optional PtiLL report presents summary infor- 
mation about each resident member of each specified unit. 


Format? (label^lCATALOG^ 
label labe I name 



tdtt, 




LlSTo optional specification allows selection of the type of catalog 

report desired for the siwclfted du's (data units). If omitted. 
LIST=PULI. is assumed. 


LIST-SIMIURT? A SUMMARY CATALOG report will be produced for each data 
unit specified, and will include: 

The data unit name 

The name of the external file on which the data unit resides 

The name of each member that resides on the unit 

t.tST"POLL (default): A PULL CATALOG report will be produced for each 

data unit specified and will include: 

The SUMMARY report of items listed above for each member on the 
data unit: 

The maximum number of records allowed 
The current number of records 
The member (record) format 
the maximum record length 

The date and time of day the member was created 

du (optional) name of a data unit, currently known in the run. about 

which the user wants a CATALOG report of the selected type. If 
omitted, the selected report will be produced for all run-life 
data units, except for system units XSUNIT and XRUNIT (if a 
restart run). Ute user may specify? XSUNIT and XRUNIT. in a 
checkpoint/restart run. 
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liixamplea t 


The following will produce PULL reports on all run-llfo data base 
units, except . for system units XSUNXT and JtflUHl’i'i 

LA8BL1 CAtALOG $ 

The following will produce a suMMAftY report on data unit DUIJ7j 
CATALCX 3 DUMt L1ST=SUMMARY $ 

The following will produce PULL reports on all run-life data base units 
except for system units XSUNlT and XftUSlT: 

CATALOG LIST*PULL $ 

The following will produce PULL reports on data units nuMI and XSUNIt* 
CATALOG L1ST»PULL, DONI , XSUNIT $ 

Restriction : Specified du's (data units) must be currently established 

in the run-life data base. 


3.S.2.2 MEMLIST CS 

purpose: the MBMLIST control statement produces a printed report about 

specified members residing on rurt-life data units. The report may option- 
ally be limited to summary information (member structure and unit residence) 
on each of the specified membersi or the PULL report can be produced to 
include the summary information plus the listing of values currently stored 
in the specified members' records. 

Format : 

where each specified member^ combination has the form 

dtt(mn) (trmt »rnl jj l^PORiiAT-foniatl 

latel label name 

Ltsm optional keyword allows selection of the type of MEMLIST report 
desired for the specified members. Tf omitted, LIST=PULL la 
assumed. 

LIS’NSttMNARt: A SUMMARY report will be produced for each member 

specified and will Include: 

The name of the data unit on which the member resides 
The name of the external file on which the member's data unit 
resides 

The name of the member 
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Th*» mpmb«*r’sj 

Maximum number of recorda 
Current number of Records 
Format specification 
Maximum record lenqth 
Date of creation 
Time of creation 

t»ifflNFWiL (default) > A PULL MEMLIST report will be produced for each 
member specified and will includet 

The SUMMARY information listed above 

The data values of each member record specified by param (rm,rn) 
below, or all member records if (rm,rn) is omittedi printed in 
the format specified by keyword FORMAT® below, or in the format 
under which the member was created if FORMAT® is omitted* 

the name of the data unit (member) to be reported on 

the optional specification of the integer sequence number (rm) 
of the record or the range of integer sequence numbers (rm, rn) 
of the records on the member whose values are to be listed. If 
omitted, the values of all the member's records Will be dis- 
played, If LIST=SUMMARY, this parameter is ignored* 

optional keyword parameter specifies the member format to be 
used in printing the indicated records* (See table 4 of 
section 3*7*) This field is ignored if LIST=SlMMAftY* 

If omitted , the Indicated records will be printed in accordance with 
the format specification under which the member was created via a 
DATA CS, LOAD CS, TABLE CS, or UPDATE CS* Unformatted records are 
always printed in octal format* 

FORMAmO produces an octal printout of the data content of the 

specified records, regardless of the format under which the member 
was created* 

FORMAT® 2RCt Indicates that the member has a card-image format; 
each card-image record will be listed on a single print line* 

F0RMA'^>8peclfied AttOFF forUt (See table 4 of section 3*7*) A 
valid ANOPP format spec' ication produces a printout of records 
in that format* The specified format is assumed to be compatible 
with the records to be printed and is not validated Internally* 

A member (record) format is expressed as a character string 
terminating with a $, as shown in the following examples; 

FORMAT®12H5(t),A30,RS$ (fixed lenqth format) 

P0RMAT®1 7Ml, 2A1 0, *( 1, 1 0RS)$ (variable length format) 


du(ttft) 

(rft) 

or 

(rM,rn) 


FORMAT ® 


Examples t 


The following Will print a SUMMARY report on data members J5M^t_and 

DHBN2« both resldent-on data unit DOTH t 

LABELl MEMLlSf LtST^SUMMARY, DOW ( DMEMI ) # DOTI1(DMEM2) $ 

Ihe following will print a POLL report on data member DMEM3 of data 
unit DOW . Bach record on the member will be listed, and the data values 
will be displayed In octal code. 

MEMLIST LIST^POLL, D0M1(DHEN3) PORMAT^O $ 

The following will print a POLL report on data member DM9 of data unit 
DU1 , listing the values of member records 1 1 and 1 2 In the format under 
which the data member was created: 

MEMLIST D01(DM9)* (11,12) $ 

Restrictions: 

Specified data units and members, du(mn), must be currently assigned to 
the run-llfe data base. 

Specified member record occurrences, (rm) or (rm,rn), must be valid for 
the member being listed. 


3. 5. 2. 3 TABLIST CS 

Purpose: The TABLIST control statement produces a printed report con- 

taining summary Information about i.ne AMOPP data tables that reside on spec- 
ified run-llfe members. In addition, a PULL TABLIST report may be selected 
that Includes the listing of the specified tables' assigned values. (Sec- 
tion 3.7.3 documents the ANOPP table types that may be created on a table 

membet. ) 

Pormat: 


labml label name 

LlSTw optional keyword allows selection of the type of TABLIST report 
desired for the specified member resident tables. If omitted, 
LIST»SUMMARY Is assumed. 

LlSmsOHMAftY (default) : A SUMMARY report will be printed about 

the ANOPP data table that resides on each specified data unit* The 
SOTIMARY report Includes the following: 

Residence data unit name 
Residence external file name 
Residence table member name 
Creation date 
Creation time of day 
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Number of Independent variables 
Length in Words 

Allowable interpolation procedures 

A FULL fABLIST report will he printed on each specified 
table and Will Include: 


The SUMMARY report information, (above) th- 

The following data on ea ch Indep endent variable defined 

table: 


The type code 

The number of table values . . ^ i 

The procedure for extrapolation beyond the last assigned 

Iftie assigned values 


value 


and the following data on the dependent variable: 


The type code 

The number of table values 
The assigned values 

du(tm) the run-life data unit name (table member name) on which the data 
table to be reported on resides 


Examples: 

The following will produce a FULL TABLIST report on data unit DUN1 
resident table-member DTBL1: 

LABELl TABLIST LIS'P*PULL, DUNI (DTBLI ) $ 

The following will produce a SUMMARY report on data unit DUN2 resident 
table member DTBL2: 

TABLIST LIST^SUMMARY DUN2(DTBL2) $ 

The following will produce a SUMMARY report on data unit DUNi resident 
table members TBL1 and TBL2, and on data unit DUN3 resident table member 
TBL1 : 

TABLIST DUNI ( TBL1 ) » DUN1(TBL2)» DUN3(TBL1) $ 

Restrictions: 

The ANOPP table residing on a specified member must have been created 
either via a TABLE CS or Internally by a functional module. 

Each specified-table residence data unit (table member) must currently 
be assigned to the run. 
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3.5.3 ATChivinil (ARCHIVE 0^ 




The ARCHIVE CS i« uaeJ to Asslqn a permanent ANOPP 

to the data coatent ot that unit aa a taaalt ^ ,tatua, 

upnMP CSe ot functional moduli processing, l^e archive 

«bUah.r la r.cotd.,1 l» tho Ihtarnal hoadar »■>“ “■* 

be- reversed during the current or any future ANOPP run or job. 

Purpose- The ARCHIVE control statement prohibits any future request to 
or job. 

Format: U«b.l^lARCMtVl?^n, ^H,|l $ 

label label name 

dah name of the data unit to be archived 

Examples: 

LAB ARCHIVE UNI, UN2, UN20 $ 

ARCHIVE, U50 $ 

Restrictions : 

Each uolt name moat ha onlque -1th raapect to the other unit na,»(a) on 
the control statement* 

Each unit to be archived must be ounently assigned in the ANOPP run. 

The archive (read-only) status prevents data unit content modification 
via subsequent TABLE CS, UPDATE CS, or functional 

does not prevent either the modification o t ® ^ ^ „nit on 

subsequent external (non-ANOPP) processing or the creation ot 
the file via CREATE CS or LOAD CS processing. 

ANOPP system scratch units (a unit whose associated external file name 
begins with the letters "XBPN") may not be archived. 


^•6 SEO^IENTIAL LIBRARY FILES 

An ANOPP sequential library file is used to store ^ «stab- 

llshed run-life data units and their members. The data are unloaded 
se^entuJ mass storage or tape file for the following reasons: 

(1) to create a data base backup cov>y 

(2) create a transferable copy of data base units 

(3) It) group a set of data base vinits 
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The AMOtP library file is identified by its ejtternal file name, it 
does not possess an AUOPP name that differs from its external file name, as 
does a data unit. 

In section 6 the sequential library files available to the user are 
identified. Ihe qroupinq of Ph requited data base items onto a Sinqie 
library reduces the number of external control cards requited for file 
assignments of a job. cross-reference tables in section 6 relate specific . 
PM. data base item requirements to the permanent data unit files and/or 
library files they reside on. ihe combined capabilities of the LOAD CS, 
UNLOAD CS, and DROP CS provide for library file creation, run assignment and 
deassignment, and stored-data retrieval. 

Assigning a sequential library file .- oust as a data unit is known to 
the run via its entry in the data unit directory, a library file is known 
via its entry in the system's library file directory. Ihe first LOAD CS or 
UNLOAD CS processed in a run that specifies the name of a. particular sequen- 
library file establishes the library-file-directory (lpd) entry. Ihe 
LOAD CS must identify as its data source a library file that was previously 
created via- an UNLOAD CS, either. in the current run or in. an earlier run* 

Ihe UNLOAD CS must Specify as its library file a sequential external file 
name not currently known to the run. (An UNLOAD CS way not specify a 
library file that is currently known in the run via an earlier LOAD or 
UNLOAD CS.) 


Terminatin g the run and job assignment of a sequential library file .- 
Ihe DROP CS terminates the run assignment and job assignment of. spiecified 
library files by removing their entries from the system library file direc- 
tory. Once a. library file has been dropped from et— run, that physical exter- 
nal file is no longer accessible in the same run. in a multirun ANOPP job, 
a dropped library file is unaccesslble until its job assignment is reestab- 
lished via external control cards (processed prior to the initiation of the 
subsequent ANOPP run). 

Establishing run-life data units using library file resident data .- The 
LOAD CS provides the capability to add new rUn-life data units, using as a 
source of data the units and members stored on a library file. The data 
units stored on a run-assigned library file are not run-life data Units; 
they are copies of previously established run-life units. The LOAD CS 
allows the user to add new run-life data units (none of which may be cur- 
rently established in the run) . A new unit may be an exact copy (optionally 
renamed) of a library stored unit, or it may be generated by using combina- 
tions of members (each optionally renamed) that reside on any of the units 
stored on the library. More than one LOAD CS may use the same library file 
as its data source. 

gullying a new sequential library file .- The UNLOAD CS provides the 
capability to build library files. The ONLOAD CS must specify the name of a 
sequential external file name (sefn) that is assigned to the user's job and 
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that la not currently known in the run via a previous LOAD or unload CS. 

Uhe UNLOAD CS allows the user to do the tollowing: 

(1) ito copy any or all of the current run-life data units to the 

library 

(2) Ito limit the library file copy: of-a-euitelife data unit to be a 

subset of its members 

Eaoh member copied to the library will be stored under its run-life data 
unit name (member name) combination. 

The user wishing to rebuild an existing library is advised to use the 
following sequence of steps: 

(1) Perform a LOAD CS or series of LOAD CS's, by using the old library 

file as the source of data and utilizing LOAD CS member- 
regrouping capabilities if required, 

(2) Perform any additional data modification required by using the 

UPDATE CS capabilLties (see section 3.7.4). 

(3) Build the new version of the library via an UNLOAD CS specifying a 

new library file name. 

(4) Use external control cards either to purge the old external library 

file and retain the new one or to retain the new library as a new 
version (cycle) of the original file. 


3 .6 .1 LOAD CS 

Purpose: The LOAD control statement creates new run-life data units by 

using as a source of data the units and members previously stored on a 
sequential library file via an UNLOAD CS (in either the current or a previ- 
ous ANOPP run) . The specified library file must be currently assigned to 
the user's job in the external system. The LOAD CS provides for selective 
loading and/or renaming ef data units and data members stored on the sequen- 
tial library file. 

Format : tlabel^lLOAD/sefn/Idu, , . • . . $ 

where each du^ has the format 

ndtt |[/mf q/ 1 [aodttl ^ 

where each mn^^ has the format 
nmttaomn 

label label name 

Sefft the name of a sequential library file, currently assigned to the 
user's job in the external system, from which stored data unit 
(member) data will be copied 
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Ada 


/e£V 


>dbi 


ludxi 


•ottii 


(optional) the name of a new data unit to be 55 

run-life data base. If members residing on mote than 
stored data unit (odu) are to be copied to the same 
repeat specification of this field is requited. If no 
specified, all of the library resident units will 
in the run-life data base on sctatoh files with no change in 

names or data coft tents# 

(optional) the name of the external tandom access file, assigned to 
the user's job* on which the new data unit will reside. If 
oMtttd' ‘ .oriteh (te««r.r,) £11. «1U b. «.«! £.r that ndu. 

If «ot. than on. LF .tot«J data unit (odu) 1 . to aupFlF «• 
for th. n« du, th. /.£n/ .p.clfl.d tor th.t n*i ndu .hould odour 

only once on the LOAD CS# 

(optional) the name of the library 
are to be copied to the neW du. If omitted, the libra^ resiaenn 

data unit (odu) and the run-life data unit (ndu) will have e 
seune neune. 

(optional) the name of the member to be created on toe ndu. If no 
nmn is specified, all odu membets are copied to ndu. 

(optional) the name of libtary unit odu resident member to be 

copied to toe ndu member nmn. If omitted, toe 

ber (omn) and the run-life member (nmn) will have the same name. 


Examples: 

The following examples will illustrate the various «®®^“f®® ®^^^® 
load S. Each example will use a previously created ®®«"®®^^®^ in 

named OLDLF, assumed to be ®^ S ihat^toied^opies 

external system. The OLDLF was created by an ONLOAD CS toat scorea p 

of data unite ONITI , 0 NIT 2 , UNITS, and UNIT 4 , each stored data unit contains 
members MEMI , MEM 2 , MEM 3 , and MEM 4 * 

T?«airinia i» The folloWinC would result in all four OLDLF stored units 
heind~eateblitoed as run-life data units under their stored names 

»U Of n« unit. “ 

scratch (temporary) external files since no efn's were specified. 


LABELA load/oldlf/ $ 

lo—nl. » . «. follo.lng «ouW r..ult In "»* 

b.in9'..ubll.w on .xt.tn.1 fil. FIbEB. H>. IWITJ «uU oonMln MEM1, 

MEM2, MENS, and MEM4. 


LOAD/O: 0LF/0NIT3/F1LEB/ $ 


r-s rc^rArbt:r.ro‘f 

renamed copy of library stored member 0NIT4 (MEM2)). 


LOAD /OLDLF/ JET0/FILBC/=UNIT4 (MEM1 


ALTTBL=MEM2) $ 
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Example 4 t Ihe following %n>uld result in the eatabliahroent of new run- 
life data units JU and PU. Unit JU would reside on external file JPIiiE and 
would be a renamed copy of OtDLP stored unit UNXTl • Unit PU would reside on 
. external file PPXLE and contain six members, ihe PU members MEMI through 
MEM would be exact copies of OLDLP stored unit UNZT2's four members, ihe 
PU members MEMS and MEM6 would, respectively, be renamed copies of members 
MEM1 and MeM 2 of OLDLP Stored unit UNZT3. Note that /PPZLE/, the external 
file name for new unit PU, is siaslclfied only once. 

LOAD/OLDLP/JU/JPXLB>UNZt1 

PU/PPZLE/-UN1T2 

Pt>>UNZl3 (MEM5-MEM1, NEM6»MEM2) $ 

Restrictions: 

Each specified new run-life data unit (ndu) and resident external file 
name /efn/ mus-t be currently unknown to the run. 

Each specified /efn/ and the external library file (/sefn/) must be 
assigned to the user's job in the external system. Any data currently 
residing on file efn will be destroyed during the creation of run-life 
unit ndu. 

Each specified library file must have been previously created via an 
UNLOAD CS, either in the current or a prior aNOPP run. 

Bach new member must possess a name unique as to the names of all other 
members created on the new unit. 

No member residing on the library file may be the data source for more 
than one new run-life member created by a single I.OAD CS. (See example 4.) 
Following the specification of JU/JPXLE/=0NZt1 , no subsequent data source 
specified on that LOAD CS, for any new data unit, could be a member of OLDLP 
stored unit UNZT1 . 


3*6.2 UNLOAD CS 

Purpose: The UNLOAD control statement establishes a new ANOPP library 

file on a sequential external tape or mass-storage file. Copies of current 
run-life data units, optionally consisting of all or some (specified) of 
their resident members, are unloaded onto the library file. Ohce estab- 
lished, the library file is available as a data source for subsequent 
LOAD CS applications within the current or a future ANOPP run. 

Format: (labml^lUNLOAC>/sefA/[dtt^,.«...dU^] $ 

where each du^ has tite format 
du(mn^,*...im^) 
label label name 
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du 


mi 


external tape or maae-stora^e £Ue, 
aaelgned to the user s job in the external system, onto which 
the run-life unit (member) data are to be copied, ihe sefn 

•'«own in the run via a previous 

unload CS or LOAD cs. 

the name of a current run-life data unit whose member data are 
to be copied (unloaded) onto the sefn. If no du is specified, 

and (except system units DATA, XSUMlt, 

and XRUMIT) will be copied to the library file. 

the name of a specified du resident member that is to be copied 
to the library, if one or more mn's are specified, only those 
named members are copied from that du. if no mn list is 


Examples t 




LABELl UNLOAD/TAPE 1/ $ 


0NIT2 


All run-life data units tJNITI and tJNIT3 will be 
will be unloaded but will contain only members 


unloaded as follows; 
MEM3 and MEMS; 


UNLOAD/BACKUP/UNIT1 , UNlT2(MEM3, MEM5),UNIT3 $ 


Restrictions t 


on thro^M CS If a d!t ! allowed 

u^oan ^ ^ ^ appears more than once on the same 

UNLOAD CS, each occurrence must specify a unique (for that du) member list. 

or riM?Han established in a run via either a LOAD CS 

or NNLOM cs, a subsequent UNLOAD CS may not address the same file in the 
same run unless it has been removed from the system by using the DROP CS. 

3.6.3 PROP CS 

^rpose : The DROP control statement terminates the ANOPP run asaian. 

fii^ assignment of the external system of a sequential library 

file, ihe droped library file will be unaccessible for the rest of the run 
dnd undccosslblo foir fho CGsf of fho tmiAoa a u a 

r...t.biuh.a VI. .vb..,u.«iy pr“:.ra “ 

i|ormat» Clabel^lDRop /sefm/(, •••,,/sefi^] $ 
l*bel label name 


sefn 


the external file name of a run-life sequential library file 
whose run and job assignments are to be dropped 
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Exang)lea t 


END DROP /TAPE1/, /DISKI /,/JETSET/ $ 

DROP /M/^TERP/ $ 

Restrlctiona i 

When a tape realdont library file is dropped^ the tape la physically 
unloaded by the external ayatemi 

When. a mass-storage resident library file Is dropped, that file Is no 
longer assigned to the user's job In the external system. 

k new library file (created via an UNLOAD CS) must not be dropped If 
the user Intends to reference that file In the external system via subse- 
quently processed- external control cards. 

Once a specific library file (sefn) has been dropped in a-user's job, 
'the same sefn specification may appear on a subsequent UNLOAD CS. However, 
unless the job assignment of the dropped file was reestablished via external 
control cards, the subsequent UNLOAD CS will not address the same physical 
file that was dropped. 


3.7 MEMBER GENERATION 

New members are generated (established on run-life data units) via the 
capabilities of the DATA CS, TABLE CS, UPDATE CS, and LOAD CS. The LOAD CS 
generates new run-life members and units by copying data stored on an ANOPP 
sequential llbr.ary file. A library file Is created via the UNLOAD CS and 
contains complete and/or partial copies of previous run- life data units. 
Section 3.6 documents the member generation capabilities of the LOM> CS. 

The DATA, TABLE, and UPDATE control statements allow the user the capability 
to define the individual records to reside on new members. All three CS's 
either require or allow the user to Input card-image data directly from 
within his primary control statement stream. This card-image data are 
either a set of data records to reside on a new member or a set of CS subor- 
dinate directives that define new units, members, or records being gener- 
ated. When the set of card images Is Included In the primary stream, it 
follows immediately behind the control statement requiring it. in this 
case, the card-image set Is terminated In the CS stream by a special END* 
Input Terminator card. 

The DATA CS creates a new member, or recreates an existing member, that 
resides on the system work unit DATA. The member will be comprised of card- 
image format records that were read directly from the user's primary control 
statement stream. 

The TABLE CS creates a new table member which Is defined by a set of 
subordinate card-image directives. The directives may either be read from 
the user's primary Input stream or from a run-life member containing the 
card-image directives. The table member may be created on system unit DATA 
or any user-established run-life data unit. 
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The UPDATE cs la a primary tool provided for the qeneration of new run" 
life membera on a apeclfled data unit* Tlie apeclfled unit muat be either a 
new run"llfe unit (eatabllahed via a CREATE CS) or an exlatlnq run^llfe unit 
(eatabllahed via an ATTACH or LOAD CS) that will be wiped clean (aero real* 
dent membefa) at the initiation ot the UPDATE CS proceaalnq phaae* Wie new 
membera may be aaalqned ahy ANOPP format apeclf Icatlon* Wiey may oonalat of 
recorda either read from any other run-life member or from within the uaer'a 
primary Input atream. 

Generation of a procedure member *- A procedure member oonalsta of a- aot 
of oard-lrtage recorda that are valid ANOPP uaer control atatementa. A pro- 
cedure member becomes a secondary CS atream when brought into execution via 
a call cs. The UPDATE CS or DATA CS provide the capability to generate 
card-image formatted records. In addition* UPDATE allows for the record- 
level modification (card-image deletion and insertion) of an existing proce- 
dure member input stream during the generation of a new procedure- member. 

Generation of table members. - A data table is a specially formatted 
single record member generated by a TABLE CS. It contains the Independent 
and dependent table values for table lookup and/or interpolation required by 
a functional module. 

Generation of data members .- Data members are members other than proce- 
dure or table members, ^e member may be unformatted or of a card-image 
format* fixed-length format* or variable-length format. The UPDATE CS 
allows the user to generate a data member of any valid format type. Ihe 
DAT^A cs allows for the generation of a card-image- data member. 

Member format .- The structure of all records on a member is defined by 
the member format specification. Table 4 presents the specification rules 
for the various types of member formats. 
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ORIQlNAt PAGE 13 
OF POOR quality 



Format tyjm [ Format-typ© apaoific^ation ruUa BiciMAploa 


Unformatted an unformatted member requiree the integer 0 (eero)* FonMAH^O 

Card imaqo A oard-image formatted member requiree the Hollerith F0RMAt^2HCX 

oharaoter etring 2HCX. 

Fixed- A member containing formatted fixed-length reoorde FORftA>>11HX#C8#RS|R89 

length requiree a Hollerith etring# the last oharaoter of FORHA1N9HX|CS|2R8$ 

format which is a $• Xho baaio apeoifioation form is FORMao>i1SHa9fa9ia9|CS,C8$ 

FORMaTk»8H3A9|2C8$ 

nHet(...|et]$ F0RMAT»14HA9,L,X, A9,L,X$ 

F0RMAT»10H2(A9,L,X)$ 

Where et is an ANOPP alpha data-type apeoifioation 
of M, RD| C8^ Lf or An that indicates a data ele- 
ment type occurring within each of the member* e 
records. (See table 1 in section 3*1*2.) 

When two or more elements of the same type or two or 
more series of elements of the same types occur within 
the format of a record, they may be shown by using a 
group specification of net or n(et, . •*,et) • Integer n 
Indicates the number of times the element type or 
series of element types repeat. Bvery second example 
shown to the right is a respeoification of the same 
format as the example preceding it, hut utilizing 
group specifications* 

Variable- Variable-length records always contain a trailing F0RMA1N4H*RS$ 

length portion of one or more elements which may occur from P0RMA'l>»6H*(RD)S 

format zero to an undefined number of times* If specified, F0RMA'ra8H^(RS,I)$ 

each variable- length record will contain a leading FORMAT»12H*(2AB^10RS)$ 

portion of one or more elements* The * is used as P0RMAT^13H*(2(L,10RS) )$ 

a special character within variable-length format F0RMAT*11HA6,*(2SRS)$ 

specifications to indicate the beginning of the FORMA*Ps12HL,I,*(10CS)$ 

variable portion of its records* The basic specif i- FORMA'^15HA7,*(I,CS,5RS)$ 
cation form is 

nHtet.**,et]*(et) ••.,et) )$ 

The element-type specification rules, presented 
above for fixed- length records, also apply within the 
fixed and variable portions of variable-length format 
specifications* The parentheses are required if more 
than one element exists in the variable portion* 

HOTEt For each oocurrence of the variable portion in 
any variable Ibngth record, each element specified as 
part of that portion must exist* 












3,7,1 END^ Input Terminator 


OWGWA'- 

OF POOR QUALITY 


Purpose: The END* input terminator card indicates the end of a primary 

input stream card-image set required by the previous DATA, UPDATE, or TABLlS 
control statement. 

Format : EtlD* $ 

Examples: 

See DATA CS, UPDATE CS, and TABLE CS for specific usage examples. 
Restrictions: 

The END* CS is valid in the primary input stream only* 

A label fiild is illegal on the END* eard. 


3,7^2 DATA CS 

Purpose: The DATA control statement creates or recreates a card-image 
(Cl) formatted member on system work unit DATA* The created member may be a 
new version of a member created via a previous DATA CS in the same run,- The 
records of the member will be the card images that immediately follow the 
DATA CS in the user's primary input stream. This input card- image set is 
terminated by the first END* card encountered following the DATA CS, 

Format : tl«b(ll^lt>ATA^t)M^rt $ 

label label ncune 

DN^n name of the card-image member to be created on system data unit 
DATA 

Examples; 

LABELA DATA DM=FM1 DATA $ 

12345 ,TRUE. 

1,5 2,5 3,4 4,5 5,5 .TRUE, 

END* $ 

DATA DM»PROCMEM $ 

LOAD/ANOPDAT/COANJET, JRS $ 

EXECUTE PMNEWJ UNIT1 =COANJET UNIT2=JRS $ 

DETACH COANJET JRS $ 

END* $ 

Restrictions : 

The DATA CS is legal only in the user's primary input stream. 

The terminating END* card will not be a card image on the created 
member . 
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3,7,3 TABL6 CS 


Purpose t The TABLR control statement builds a user^specifled ANOPP 
data table on a run^llfe table member, flie data table is structured in 
accordance with a set of user-supplied table-description card Images, The 
card-image set may reside Immediately following the TABLE CS In the user's 
primary Input stream or on a user-specified card-image run-llTe member. 
Description cards required for the definition of ANOPP data table types are 
documented below, 

Porrnats Uabel^lTAfiL^(t«J^tyf>6^0imcB-(3urt(mrt)} $ 
label label name 

the data unit name (table member name) on which the data table Is 
to reside. Hie du may be any user-established run-life unit or 
system unit DATA. 

type . the integer ANOPP table type of the data table being built. 

Current valid table types are documented below ___ 

SOURCES specifies where the table-description card- image set, required 

to define the ANOpp table-type specified, resides,— Table- 

description card sets are documented below. 

indicates that the card-image set follows immediately 
behind the TABLE CS in the user's primary Input stream. The set 
must be terminated by an END* input terminator card. 

SOUftCtMluit(mn) indicates run-life data unit name (member name) on 
which the card-image table-description set resides. 

Examples; 

A type-1 data table will be built on unit FMIUNIT resident table member 
FANTAB. The table-description set will be read from card-image member 
FANTDCS residing on system unit DATA as-follows; 


LABELA TABLE FMIUNIT( FANTAB) , 1, SOURCE=DATA( FANTDCS) $ 

The same table creation results as for example 1 in section 3,6,1, but 
here the table-description set is read from the user's primary input stream 
and is terminated by an END* card as follows: 


TABLE PMIIINIT( FANTAB) 1 SOimCE«* $ 
iNTa 's 

INDIa.,... \ table-type-1 description 

DEPa J 

END* $ 


card set 


Restriction; A TABLE CS having a specification of SOtlRCE=* is valid 
only in the user's primary input stream; specifications of SOltRCE=dun(mn) 
are valid in any CS stream. 
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ftNOPP data table type-1 description cards t flhe concepts and definition 
of an ANOPP type*1 table are presented in section 2.3*1 .2*2. Ihe table 
type-1 description cards are of the foliotrinq formatt 

INT» ipc. ipc. ipc 

INDjj- ifc,rtV,e>cu,exl,ival,, ,,,,,ival-„ 

DE^ dfcfdval^ «dvdl2**... 

which are defined as follows: 

XNT card contains the integer codes for the interpolation procedure 
that will be permitted on this table 

ipc integer code: 

0 no interpolation- 

1 linear Interpolation 

2 cubic-spline interpolation 

IMDn card contains the description of and the table values for the nth 
independent variable where n < 4 

ifc (format code) the alpha data-type code of the nth 
Independent variable 

0 ordered position from 1 to nvj independent 

Variable values not entered 

1 integer 

RS real single precision 
RD real double precision 

nv number of values for the nth independent variable 

exu integer code for the extrapolation procedure to be 

used (during interpolation) if a specified value for 
this independent variable falls beyond the last 
table value (ivalj^^) for the independent variable 

0 no extrapolation allowed 

1 use the independent-variable table value closest 

to the specified value 

2 extrapolation is linear when using the last two 

table values for the independent variable 

exl integer code for the extrapolation procedure to be 

used (during interpolation) if a specified value for 
this independent variable falls before the first 
table value (ival^) for the independent variable 

0 no extrapolation allowed 

1 use the table value of the independent variable 

closest to the specified value 

2 extrapolation is linear when using the first two 

table values for the independent variable 
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ival nv table values for the nth Independent variable In 

ot a.«.naiM ord.r. ». 1 «. .r. ..paMwa 
by blank or coiMha and may extend over several card 
Ifta^dsa If ifc-0, values are not Included. See 
table 1 Ift section 3.1 .2 for numeric-value specifi- 
cation exantples. 

Tf oniv a slndle value Is given for the Independent variable (ny-1) 
And either exu ot exl equals 2, the systeift will print an infottnatl^e dlag- 
“ttlc^na Tiia tSl. -Itt th. «tr.poX.tlo» p.r«. (.x. or oxl) ... 

to 1 . - 


DEP card 


contains the description and table values for the dependent 
variable and must follow the 1ND„ cards 

dfc (format code) alpha data type of the dependent 
variable 
1 Integer 

RS real single precision 
Rb real double precision 
CS cotiplex single precision 

dval the table value for the dependent variable, separated 
by commas or blanks, and extending over several card 
images as required, ihe order of 
ables Is such that the first Independent variable 
varies first, the second variable varies second, the 
third variable varies third, and the fourth 
able varies last. See table 1 ifi section 3.1*2 
stjecif ication examples. 


END^ card required if SOURCE®* • 

Examples of TABLE CS tvpe-1 ta Hi«» descriptions t 

lab table UNI(I»4S),1,S00RCE»* $ 

liJD2»l,2,0,l ,5,10 
llJD1=RS,3,0,1 ,1 .5,2.0,4.5- 
DEP«1,3,5,7,8,9,10 
END* $ 


table UNI(DMT) 1 SOURCES* $ 


lMT-0 1 

lNDl-1 21123 
IND2»RS 2 2 2 3.4 7.8 
1ND3“RD 222 4D0 3DO 


1ND4-RS 2 2 2 3. 2. 
DERxCS (12. ,12.) (13., 
(12. ,12.) (12., 
(12. ,12.) (13., 


13.) (13., 

12 . ) ( 13 », 

13. ) (10., 


13.) (14 
13.) (11 
10 .) (11 


., 14 .) ( 11 ., 11 .) 

., 11 .) ( 12 . , 12 .) 

., 11 .) ( 11 . , 11 .) ( 12*»1 


2 .) 


END* $ 


note, currently, th. only valid dat.-t.bl. typ. r.eo 9 oU.d by ANOPP Is 
type 1 . 
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3«7«4 the UPDATE Proeesalncf Ehase 


3. 7. 4.1 CHrerview 

The processing of an UPDATE CS In the user's input stream initiates the 
update processing phase. During this phase, the system will generate all 
new members onto a specified run-life data unit. During the update phase, 
and in accordance with a user's set of update directives, the system will 
generate the. new unit members by» 

(1) Copying the contents of specified existing run-life members 

(2) Copying new-rnember data records directly from the primary input 

stream 

(3) Building new members by combining records copied from an existing 

run-life member and from the user's update directive set 

The UPDATE CS that initiates the update processing phase specifies: 

The new unit to receive the generated members 
The source Where the card-image update-directive set resides 
The processing mode (create or revise) for thi s - . up date phase 
The content of the update processing report 

The new unit to be built during the- update phase should have been previously 
established in the run via a CREATE, ATTACH, or LOAD CS. At the start of 
the update phase, any resident members on the user-specified, new unit are 
destroyed* the update-directive set is a set of card images that either 
resides oiv a user— specified run— life member or that immediately follows the 
UPDATE CS in the usee's primary input stream (an END* input terminator card 
establishing the end of the directive set), the update directives allow the 
user to define the new membe-rs to reside on the unit being built and to 
specify the source of each new member. The update processing mode is deter- 
mined by the user's inclusion or omission of a primary old data unit speci- 
fication on his UPDATE CS. 

The update create mode is in effect if a primary old unit is not speci- 
fied on the user's UPDATE CS. Under this mode, the -ADDR member-level 
directive may be used to generate new members copied from specified run-life 
units or from within the input stream. The -CHANGE member-level directive, 
and its subordinate record-level directives, may be used to mix existing and 
new records onto a new member. In create mode the user must always specify 
on each member-level directive the run-life unit residence of any data- 
source member. Each new member must be generated by a single member-level 
directive application. 

The update revise mode is in effect if the user specifies a primary old 
unit on his UPDATE CS. A specified primary old unit should be the primary 
source of nm-life member and record data for the new unit being built* 
Typically, this is an existing unit, the content of which is being revised 
or updated* UPDATE CS applications never result in a change of data occur- 
ring on the old source unit or member. Under the revise mode, the user has 
access to all the directive capabilities available under the create mode, 
including the use of any run-life member as a record source. In addition. 
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he has access to two additional member-level directives, the -COPY and -OMIT 
directives. The -COPY directive allows for copyinq (unchanged) specified 
members from the primary old data, unit. The -OMlf directive allows for 
specific identification of primary old data-unit resident members that are 
not to be copied to the new unit, the -COPY and -OMIT directives, used in 
conjunction with the optional UPDATE CS keyword AtL, allow the user to copy 
by default all the primary old unit members not specifically omitted, 
copied, replaced, or changed by a meffiber-level directive. Revise-mode pro- 
C68sln^ also allows tite ussr to default on his data-*soUrce unit specif tea— . 
tlon on most update directives, in which case the primary old unit is 
assumed* 

A printed update processing report is produced by the system to 
describe the data unit, member, and record generation that occurred during 
the processing phase just completed. The report will contain as a minimum 
the header section described below. The optional LIST» parameter of the 
UPDATE CS allows the User to select additional. sectional content to appear 
in the report. He may specify any combination of the four alpha characters, 
each of which requests a different titled update report section to be 
printed. The report sections, the LIST* value specification that selects 
them, and their information content are given as follows: 

Header section: 

Printed following the completion of each update processing phase 
Contains: 

The update mode (create or revise) in effect during the pro- 
cessing phase 

The name of the new data unit generated 

It- revise mode, the name of the primacy old unit used 

The source from which the Update directive set was read, either 
the user's primary input stream or a run-life data unit name 
(member name) 

The user specified UPDATE CS LIST* selections 
Directive echo section: 

Included in report if LIST= selection contains letter E 
Prints each card image in the user's update directive set 

Summary section: 

included in report if LIST* selection contains letter S 
Contains: 

The total number of members generated on the new data unit 

For each new member generated: 
the name of the member 
The number of records on the member 
The format specification of the member (records) 

The maximum record length (number of computer storage words) 
The type of the update member-level directive (-COPY, -ADDR, 
or -CHANGE), or the UPDATE CS keyword ALL that controlled 
the generation of the member 


ADDR member section: 

Included in report If LlSlv- selection contains letter A 
Contains, for each member generated by a user's -ADDR member-level 
directive: 

the name of the member 

the format specification of the member (records) 

A list containing the stored data in eacb-of the member's 
records, presented in either: 

Card-image (10A8) form if member is type cl (card image) 

Octal code, five internal con^uter words per line, if member 
is type unformatted or FORMATTED 

CHANGE member section: 

Included in report if selection contains letter C 

Contains, for each member generated by a user's -CHANGE member- 
level directive (and its subordinate record-level directives) , 
the same information as presented on AI)DR member-section reported 
members 

The typical ANOPP user Will build data units via the UPDATE CS specify- 
ing either an existing run-life member or a set of input streaua records as 
the only source of data for each new member generated. Since the -ADDR 
member-level directive will be their primary tool, these users may Wish to 
skip the documentation of the other directives. Ihe large ANOPP application 
User reguires the capability to perform record- level member modification and 
generation. He will use the -COPY, -OMIT, and -CHANGE member-level direc- 
tives and the subordinate -INSERT, -DELETE, and -QUIT record-level 
directives. 


3. 7.4. 2 UPDATE CS 

Purpose: ihe UPDATE control statement initiates the ANOPP update pro- 

cessing phase, during which new resident members are generated onto a user- 
specified run-life data unit. The UPDATE CS requirer a set of subordinate 
update directives, read either from within the user's primary input stream 
or from a specified card-image run-life member. The update directives allow 
the user to copy specific old members from run-life units onto the new unit: 
to add new members consisting of records read from within the user's update 
directive set: and to build new members by using selective copying, inser- 
tion, and omission of records residing on an old run-life member and/or new 
user input records. At the initiation of the update processing phase, the 
specified run-life unit being built (or rebuilt) is wiped clean. 

Format : 

(iabe]^lDPDAT^[OLbO-pdtt^]MEMU-ndii^tALL^]sdaRc» (!(«»)} * .a] $ 

label label name 

OlOtkxpdtt (optional) keyword specifies the name of a run-life data unit (pdu) 
as the primary source of member and record data for the new mem- 
ber ndu being generated 
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aa« Z^^rdV. au.=ti«. -«y b. ae«.i«a 

to primary unit pdu* 

l« o«ltt.d, th. ajaat. b«at. a^a .lU cTbX’a 

and -OMtt directives my not be used, and tne wutMt. 

parameter ALL la Ignored by the system. 

-*-f— a«K K«rt«ired keyword parameter specifies the name (ndu) of 

the update processing phase. 

^T.T. (optional) keyword Is meaningful only In update revise m 

processing. 

If apaclftaa undar thla .ada 

data unit (OLDO«pdu), except for: 

a «a aa t-h» data-source member via the 
A member that was spec anoR or -CHANGE directive 

OLDM- keyword parameter on a -ADDR or -chrhgb axr 

d«daa ,^n a -COPY or -OMIT directive 
R member that was specified on a -co 

" rn"S: :;^ru„rvirr-»Drc 

so»«*. thU kayv„.rd apaclflcatlan idantltia. whaf, th, card-iaad, updat, 
directive set resides 

terminator card. (See section 3.7.1.) 
dun (card-image member dmn). 

S:=“Fiint;-rr. sT-'.-irS”'”' 

ToS^ta wo" iTll ;!;«!» om, », haad,r aactlon. dha 
valid lUt characters and the report aectlons ey 
qenerate are: 

E Directive echo section 
S Summary section 
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C CHANGE member section 
A ADDR member section 


Examples! 

the following run-life unit 01 will contain the neW members generated 
in accordance With the update directive set. Since no primary data-source 
unit was specified (OLOt^), only create mode valid directives may be used. 
An update processing report will be printed which contains all sections 
except for the directive echo section. . 


LABi-UPDATE NEWU»U1, S0URCE=*» L1ST»SCA $ 

IchSge! *.!*.!!*.} wember-level directives "I 

-INSERT... > 
-DELETE. . . \ record- level directives | 

-Q0IT.....J J 

END* $ 


Primary input stream 
update directive set 


The following run-life unit NEWPAN will contain the new members gener- 
ated in accordance with the card— image directive set residing on unit 
U7(member MEM9). The update revise mode is in effect with run-life unit 
PAN01 identified as the primary data-source unit) all update directives may 
be used, the ALL keyword specification will result in all unit PAN01 mem- 
bers that were not specified on any member-level directive being copied to 
unit NEWPAN. the omission of the LIS'N keyword will result in an update 
report consisting only of the header section. 

UPDATE 0LDU=PAN01 NEWU=NEWPAN ALL SOORCB*07(MEM9) $ 


NOTE: Examples illustrating the use of the UPDATE CS and specific member' 

level and record-level directives are presented in section 3. 7. 4. 5. 


3.7 .4 .3 Member-Level Directives 

The general format of update member-level directives is 

direfetivertame^fleld^««.»field^ $ 

The valid directi venames are as follows: 

-COPY (valid in update revise mode only) 

-OMIT (valid in update revise mode only) 

-ADDR (valid in all update processing modes) 

-CHANGE (valid in all update processing modes) 

The fields are as specified in the following subsections that docu- 
ment the Individual directives. Field separation, continuation, and value 
specification rules are as documented for ANOPP control statements in 
section 3.1.2. Labels are Illegal on member-level directives. 
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3.7 .4 *3.1 -COPY dlreotl/e 


^rposet Ihe -COPY update member-level directive will generate one or 
more user-specified new unit members. Each new member is an exact copy of 
the member of the same name residing on the primary old unit (identified by 
the UPDATE C8 keyword OLDU-). 

pormat t $ 

M the name of the member to be generated on the new unit that will be 

an exact copy of the primary old-unit (OLDO») resident member of 
the same name 

Exaftplfla I 

-COPY LJET023, LJET127, LJET219 $ 

-COPY LJET019 $ . 

NOTE: Examples of UPDATE CS applications utilizing -COPY directives in 

addition to other member-level directives are presented in section 3.7 .4.5. 


Restrictions : 

Label fields are not valid on member-level directives. 

The -COPY directive is valid in update revise mode processing only. 

Each specified new member name (nin) must be unique as to all other 
members generated on the new unit via any member-level directive in the same 
update directive set. 


3 .7 .4 .3 .2 -OMIT directive 

Purpose: The -OMIT member-level directive is valid only during update 

revise mode processing initiated by an UPDATE CS on which the keyword "ALL" 
was specified. (See section 3.7 .4.2.) The -OMIT directive is used to spec- 
ify the names of one or more primary old-unit (UPDATE CS parameter OLDU^) 
resident members that are not to be copied to the new unit during the final 
revise mode processing step. 

Format: 

mm the name of a member residing on the UPDATE CS specified primary 

old unit (OLDl>») that is to be omitted from the new unit (NBMU») 
during update revise mode "ALL" processing 

Examples: 

-OMIT LJET024, LJET126, LJBT220 $ 

-OMIT LJETD20 $ 

Restrictions : 

Label fields are not valid on member-level directives. 
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The -^MIT dtractive la valid only in a revlae mode proceaalng phaae 
Initiated by an UPDATE CS on which the keyword "ALL" was apeclfied. 

If the aame OLDU reaident member ia specified on both a -COPY directive 
and -OHXT directive In the same aet, the speolfied member Will be copied to 
the new unit. 


3 .7. 4. 3. 3 -ADDR directive 


Purpose t The -ADDR u{x3ate member-level directive allows the user to 
define and generate a member on the new unit being built under- any update 
processing mode. The record content of the new member may be copied from 
any specified run-life member (format 1 below) or read from the card images 
that follow the -ADDR in the user’s primary input stream (format 2 below). 

When the record data are read from primary Input stream card Images « 
the user may optionally define the format specif lea tlon and maximum number 
of records for the new member. 

Format 1 t (valid within a primary or secondary Input stream) 
~ADDty>LDMs^^H[|^^ [^WflOfstUUl] $ 

OUM» required keyword specification of the run-life member whose records 
are to be copied to the new unit member being generated... Also, 
the name of the new member If optional keyword NEWM» Is omitted 

OLOMopan Is a valid specification only In update revise mode pro- 
cessing. The specified pmn must be the name of the member resid- 
ing on the primary old unit Identified by UPDATE CS keyword 
OLDU». 

OLHladU(tti) Is a specification of the run-life data unit name 
(member name) whose records are to be copied to the new member. 
(This is valid in any update processing mode.) 

MEMI^onmn (optional) specifies the name of the new member nmn being generated 
on the new unit. If omitted, nmn equals the name of the copied 
member, regardless of Its unit residence. 

Format 1 examplest 

The following revise mode must be In effect since the run-life resi- 
dence of old member JETMEMI Is assumed to be the primary old unit specified 
by UPDATE CS keyword OLDU=. The new member will be named JETD08 and will be 
an exact copy of member JETMEMI • 

-ADDR OLDMaJETMEMI . NEWM-JET008 $ 

The following specification Is Valid In any update processing mode. 

The record content of member MEM8. resident on run-llfe unit UNIT?. Will be 
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copied to the new unit member being generatedt Ihe new member will also be 
named MGM8* 

-AODR 0bDH»UNIT7(MBMa) $ 

ty>rtf>at 1 reatrlctlons j 

fhe name of the new member « whether specified or aeaumedi must be 
unique on the new unit. 

Label fields are Illegal on member<-level directives. 

Format 2x (valid within a user’s primary Input stream only) 

-ADDR Ot0(-*^EMMHin[^FOItMA1>>foriiatH^IMl^ $ 

OLOlo* this specification Indicates that the record data for new member mn 
Is to be read from the card Images Immediately following the 
-ADDR In the user’s update directive set; the record data set Is 
terminated by the next member-level directive read or by the EMD* 
card that terminates the update directive set In the user’s 
primary Input stream. The record card-image data must correspond 
to the FORMAT specification supplied or assumed for the new mem- 
ber, as documented below. 

SBnMil required specification of the name (mn) of the new member being 
generated. The name cannot be a duplicate of the names of the 
other members generated on the new unit. 

FORMAT^ (optional) keyword specification of the format type of new mem- 
ber mn. Valid format specifications are as docvunented in 
table 4 In section 3.7. If omitted, P0RMATs»2HCI . 

FORNAf^O Indicates that the records are of undefined format and 
variable length (unformatted) . Each data field on the card 
images will be Interpreted as an AMOPP data type. (See table 1 
In section 3.1.2.) The internally converted data will be written 
to the unformatted records. The occurrence of a $ on a card 
image terminates and Is not part of the data record being built; 
the data for the next record are assumed to begin on the 
following card Image. 

FORHAl^«2ttCi (default) Indicates that a catd-lmage member Is to be 
generated. Bach Image following the -ADDR, up to but not Includ- 
ing the next member-level directive or END* card, will be a 
record on the new member. 

FDRMAf^RO| » • • • $ Indicates a fixed or variable-lenqth format 

specification for the new member. As documented in table 4 in 
section 3.7, the FORMATTED member will contain records whose ele- 
ments are of the data types shown In the specification. Tbe 
Input data card Images must contain value expressions that corre- 
spond In type and sequence with the specified format. The occur- 
rence of a $ terminates and is not part of the data record being 
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ganerata4. 1»ie next Input racord's data are aaaumed to begin on 
the next input card image, 

MMItsii (optional) integer speoitication of the maximum number of records 
that new member mn may contain. If omitted, the system default 
of MNR«10000 is used for the new member. 

Format 2 examples t 

New unit membor JETM8 will be generated. Its format will he default- 
type card image (Cl), It will contain three records, each consisting of one 
of the subsequent card images. Member JETM8, which may contain a maximum of 
10 records, is given as followst 

-ADDR 0LDM-* NEWMaJE'TMe MMR<»10 $ 

RECORD 1 HILL BE THIS CARD-IMAGE 
RECORD 2 " " " " " 

RECORD 3 •* « “ •• '• 

(Next update member-level directive or the END* input terminator 
card) 

Member M4 is created as a new unit unformatted member containing 
three records and having a default maximum number of record value of 10000. 
The individual records generated will each possess the record length (in 
internal computer storage words) required to store the converted data values 
supplied for it, ihose values will be: 

For record 1 - one type RS (real single) value 

For record 2 - two type RD (real double precision) values, one type 

L (logical), one type A3 value (Hollerith string of 
three characters) 

For record 3 - three type I (integer) values 

Member M4 is given as follows: 

-ADDR OLDMa*, MEWM»M4, FORMAl^O $ 

.693 $ COMMENTS ANYONE? 

.70D+01 .898D+20 .TRUE. 3HABC $ 

10 20 30 $ 

(Next member-level directive or the END* input terminator card) 

The following member M5 will be a formatted fixed-length member con- 
taining two records and a value of default of 10000 for a maximum number of 
records: 

-ADDR OLDMa*', NEWMaMS, FORMAT* 1 7H1, 2RS,A9,RD,CS,L$ $ 

I 1.5 2E+01 9HJET-STATS 3D-01 (1.5, 2.0) .TRUE. $ 

II 977.8 -.696E-110 9HPR0P-STAT 1075.5D+01 ( .696B+29 

.32E<t>31) .FALSE. $ 

(Next member-level directive or the END* input terminator card) 

NOTE: Examples of UPDATE CS applications utilizing -ADDR directives in 

addition to other member-level directives are presented subsequently in 
section 3. 7. 4. 5. 
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The following member COORD oontalne the X, Y# Z needed for the geometry 
module: 

-ADDR ObDM^*, NEWM=C00RD, PORMAT-4H3RS9 $ 

0» 0« 4» I? 

END* 

Format 2 reatrlotion Bt 

The AODR Keyword Bpeelfloation OLDM»* 1« valid only withln- A-uaer-'-a.. 
primary Input etream. 

The name of the new member (NE«M») must be unique on the new unit being 
built. 

The FORMAT* specif lea tlohs must corrospond with the rules dooviiftented in 
table 4 in section 3.7. Individual data-reoord values specified on input 
card images must correspond in type and sequence with the FORMAT* specif- ca- 
tion and must correspond to tiie value specification rules presented In 
table 1 in section 3.1.2. 

•*****•***•********<»****************************•***•***•*********•********* 

* 

* NOTE * 

* * 

****»*«**#<»****<fe********************************^**’******'****************** 
* * 

* The remaining directives in this section are intended for large- * 

* application users who will establish and maintain large data base • 

* applications. ^ 

#*********•***<••*************************•***********•**•******************* 


3. 7. 4. 3. 4 -CHANGE directive 

Purpose: The -CHANGE update member-level directive allows for the 

generation of a new unit member, vdiose records will be selectively copied 
from a user-specified old run— life member, with optional Insertion of addi- 
tional new records read from within the user’s card— image update directive 
set. The sequence and source of new member records to be generated are In 
accordance with a set of card-image record-level directives subordinate to 
the -CHANGE directive. 

The new member will possess the same format as does the specified old 
member; the name and rnaximuin-number-of-records value of the new member may 
optionally be changed from that of the old member. 

A set of record-level directives must immediately follow the -CHANGE 
directive it supports in the update directive set. Ihe occurrence of a 
subsequent member-level directive, or the termination of the user’s update 
directive set, ends the -CHANGE subordinate record-level set. 

Format : -CHAMG^Uila^l^^^ (^ftaWNiUin] $ 
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specifies the run-life member whose resident records will be 
selectively copied onto the new Member In accordance With the 
record-level directives set 

OLONopMA Is valid only In update revise-mode processing* The 
specified old memhoit (pmn) roust be resident on the primary old 
unit Identified via the UPDATE CS keyword OLDU« specification* 

OLOH<^u(an) Is valid in any update processing mode and specifies 
the run-life data unit name (Merober name) of the old member* 

NBHM»nron (optional) specifies the name of the new unit member beln^ 

generated* If omitted, the name of the specified old member 
(OLDKa) will also be assigned to the new member. 

MMlb>n (optional) specifies the maximum number of records for Integer n 
that the new member may contain. If omitted, the system will 
calculate the new member's MNft value based on the old member's 
MNR value and current number of records. 

Examples; 

Since the run-life data unit residence of old member Ml was not speci- 
fied, this must be a revise-mode update, initiated by an UPDATE CS on which 
a primary old unit (OLDU=) was specified. In accordance with the record- 
level directive set, the following new Unit member JETM1 will contain 
records selectively read from primary old-unit member Ml and, optionally, 
records read from within the record-level directive set; 

-CHANGE 0LDM=M1 ,NEWM=JETM1 $ 

(Recgrd-level directives) 

# 

(Member-level directive or the end of the user's update directive 
set) 

The following new unit member MEM2 will be created with an assigned 
value of 2000 for maximum number of records. In accordance with the record- 
level directive set, records will he selectively copied to the new member 
from run-life unit PANU member MEM2. 

-CHANGE 0LDM=PANU(MEM2) MNR=2000 $ 

(Record-level directives) 

(Member-level directive) 

NOTE; Examples of -CHANGE member-level directive applications rising spe- 
cific subordinate record-level directives are presented In the fallowing 
sections, .Section 3, 7 *4, 5 presents examples using combinations of all 
update memlwr and record-level directives. 
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3*7. 4. 4 Record-Level Directives 


■t 

A 


general format for -CHANGE subordinate record-level directives Is 

diMetlV8iiai«C^<leld— $ 

The valid directlvenaroes afe 
-INSERT -delete -quit 

The fields are as specified in the following subsections that document 
the individual directives. Field-separation and value-specification rules 
are as documented for ANOP? control statements in section 3.1 .2. Labels are 
illegal on record-level directives. Ifee record-level directives are pro- 
cessed under control of the preceding -CHANGE member-level directive. The 
-CHANGE directive, documented in the previous section, performs the 
following: 


Identifies the new unit member whose record content will be a changed 
copy of the current content of a run-life old member 

Identifies the old member (OLIM-) 

Remains in control until each of its 8uboedinai:e..xeco E d.-«leveX 
directives have been processed 

Bach directive generates the copying of single oi.* groups of records either 
from the old member or from within the directive set. Throughout a record- 
level directive set, the integer operands i and j are used as pointers to 
relative record positions in the old member. Directives within a set must 
be processed (and positioned) sequentially with respect to any i and j oper- 
and specifications they possess. This is necessary because the new member 
is generated in one pass. 

The system monitors an old member reference pointer P throughout the 
generation of a new member via a -CHANGE and its record-level directive 
set. Here, P is initiated at zero. Upon completion of each directive's 
processing, P assumes one of the following values: 

(1) The j value (if specified on the directive) 

(2) The i value (if specified, and j value not specified) 

(3) Unchanged (if i value not specified) 

The next record-level directive must have an i value (if present) greater 
then the new value of P. 

The i operand on a directive specifies the relative record position of 
the first record in a sequence cf one or more old-member records. Depending 
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on the directive, this atnqle or sequence of old-member records will be 
treated as follows* 

copied to the t»« mesber, optionally to he follo^d ^ 

eeootde read from the oard Imayos Immediately tollowlnq tha directive 

or from elsewhere in the old member 

omitted from copying to the now member 

The 1 operand, optionally used on the -DfiLETfi directive. Is used to 
specify the Ust old-member record In a series to ^ 
tT the new member, the I value (If present) on “"J. f 
greater than the I (and j. If present) value specified on a 
Lrectlve In the set. fbr example, a directive referencing old-member 
records 5 through 8 (I throu#* j) must be processed before one referenc- 
ing 9 through 10 (I 2 through j 2 ). and never vice versa. 

The -OUIT directive. If encountered, terminates the new-member genera- 
tion ^oceS anrthe -cnluiGfi directive's subordinate set. It may specify 
that some, all, or none of the remaining old-member records be copied 

as a Tlnal generation step. If -QUIT Is not used, ^e set te^l- 
nates with the occurrence of another update member-level 
th. crmlnatloh of th. opdat. dlcetlv. s.t. 

member records from the new-member copy Is performed via the DELETE dlMC 
tlve. insertion of new records read from directive set card Images Is per- 
fumed via the -INSERT directive. Reseguenclng records onto 

the new-member records la performed via the -INSERT directive. 

3. 7. 4. 4.1 -INSJRT record-level directive- 

Purpose: The -INSERT record-level directive allows the user to insert 

onto the nei^ member a group of one or more sequentially ' 

either currently residing on the old member or Immediately following the 
directive card Image In the record-level directive set. 

Optionally, the user may specify that a group of one or 
records Will be copied onto the new member to precede the Inserted records. 


Format 


J -INRSRT^ti^l 0 


(optional) the Integer relative position of the last old-member 
record to be copied to the new member prior to the specified 
records to be Inserted. Integer I must be greater than old- 
member record pointer P. Records P + 1 through and Including I 
will be copied to the new member. 

If omitted, P remains unchanged, allowing records to be Inserted 
at any position on the new member. Including at the beginning 
when P = 0. Ihe concepts of old-member record-pointer P ate 
presented In section 3.7 *4.4. 
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(optional) specifies the source of the records to be inserted onto 
the new member. If omitted, PROMb* Is assumed. 

FftOI-* (default) indicates that the records to be inserted on the 
new member immediately follow in the directive-set card imacfes. 

Bie new record card intakes are terminated by the next record- 
level directive, member-level directive, or termination of the 
directive set. FROM®* is valid in any CS stream. The new record — 
data must correspond to the format specification of the -CHASGfi — 
specified old- member. (See table 4 in section 3.7.) 

If the format of OLDM is unformatted, fixed, or variable, then a $ 
must terminate the data of each input record and the next record 
must begin- on a separate card image, ^plicable examples are 
presented below and in the following subsections. 

ppCM>OlilXt indicates that the records to be inserted on the new 
member reside on the -CttAMGS specified OLDN and are specified 
by the next operand field. 

(mt,nl) (optional) specifies which old-member record (m) or sequence of 
old-member records (m,n) are to be inserted on the new member. 

This field specification has no effect on old-member record 
pointer P. The integer value of m or n may be greater, less 
than, or equal to an i-parameter specification; n, when speci- 
fied, must be greater than m. If FROM®*, this field is ignored. 

If omitted, and FROM-OLDM, all OtoM records will be inserted on 
the new member* 

Examples; 

Example 1 ; Assume that N1 is a card-image formatted member on the 
UPDATE CS specified primary old data unit. Assume that the user desires to 
Insert two new cards following the sixth card-image record of the old mem- 
ber, The following would copy the first six records onto the new member and 
then insert the two new ones: 

-CHANGE OLDHbNI $ 

-INSERT 6 $ 

(Card image) 

(Card image) 

(Next member-level directive) 

Example 2: The following directive would copy the first six old-member 

records to theT new member, to be followed by an insertion of a second copy 
of old-member records 1 through 3. Following this process, P would equal 6. 

-INSERT 6, FROM-OLDM (1,3) $ 

Example 3: The following is a second example of the -INSERT capability 

to reorganize old-member records onto the new member. The old memoer con- 
tains 30 records, consisting of 3 functionally related groups of 10 records 
each. Assume that the user wishes to retain all the records but Intends to 
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position- the second related group (old-member records 11 through 20) at the 
beginning of the new member, the following would perform the desired 
resequencing; 

-INSBRt PROM=OLDM (11,20) $ Copy records 11 to 20. 

-INSERT 10 FROM OLDM (21 ,.301 $ Copy records 1 to 10. 

Copy_records 21 to 30. 

Example 4: For the following example# assume that the OLOU data unit 

is UNI and the user Wishes to create a new unit member based on run-life 
unit UN3 member MEM7. MEM7 has a fixed-length format specification of 
FORMATs6H3l, 3L$ . It contains- 10 records-, all to be retained on the new 
member. The user intends to insert from within his directive set one new 
record behind old-member records 5 and 10. Ihe new member will retain the 
name MEM7. 

-CHANGE OLDM«UN3(MEM7) S 
-INSERT 5 FROM-* $ 

2765 8329 10754 .TRUE. .TRUE. .FALSE. $ 

-insert 10 FROM-* $ 

6439 10376 7420 .tRUE. .FALSE. .FALSE. $ 

(Next member-level directive) 

NOTE: Additional -INSERT directive examples are included in the following 

subsections presenting the -DELETE and -OMiT record-level directives. 

Restrictions : 

New data records must correspond to the member format of. OLEW. 

A value specification for operand i must be greater than that specified 
for operands- i or j on any preceding record-level directive in the set. 


3.7 .4.4.2 -DELETE record- level directive 

Purpose : The -DELETE member-level directive allows the user to bypass 

old— member records that are not to be copied to the new member being gener- 
ated. (^tionally, the user may cause a preceding group of old-member 
records to be copied to the new member. 

Format : 

il.jl the integer operands i and j specify a range of old-member 

positioned records that are not to be copied to the new member, 
■flie i must be greater than the current value of old-member 
pointer P; and j, if specified, must be greater than i. 

If 1 is less than i, old— member records p + 1 through 
i - 1 are first copied to the new member. 

Pointer P is set to the value of j, or to the value of i 
if j is not specified. 
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Example > 

Aasume that old-member JBT1 resides on the primary old data unit and 
contains 20 records. Old-member records 9, 10, 15, 16, and 17 are to be 
deleted. New records afe to be Inserted following current old-member 
records 5 and 12 on the new member. In addition, current old-meraber 
records 2 and 3 are to be moved to -the end of the records on the new member. 


-CHANGE-OLD M aJBiTI $ 


At Initiation, old-member record pointer 
Is Initiated. (PbO) 


OBLBfB 2,3 $ 


Old-member record 1 Is copied. (P»3) 


INSERT 5 FROM®* $ Old records 4 and 5 are copied* New 

(New record N1 card images) reeords Nl and N2 are inserted. (P=5) 

(New record N2 card Images) 


-DELETE 9,10 $ 


Old records 6 through 8 are copied. 
(P»10) 


-insert 12 From** $ old records 11 and 12 are copied. 

(New record N3 card images) New record N3 is inserted. (P*12) 


DELETE 15,17 $ 


Old records 13 and 14 are copied. 
(P*17) 


-INSERT 20 FROM«OLdM (2,3) $ Old records 18, 19, and 20 are copied. 

Old records 2 and 3 are then copied. 
(P»20) 


(Next memlser-level directive) 


The new member Would now contain: 


OLDM 

Rec 

1 

II 

ft 

4 

II 

tt 

5 

New 

Rec 

Nl 

It 

It 

N2 

OLDM 

Rec 

6 

ti 

It 
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It 

It 
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It 

It 

11 

It 

It 

12 

New Rec 

N3 

OLDM 
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13 

It 

tt 

14 

It 

It 

18 

It 

It 

19 

It 

It 

20 

It 

It 

2 

It 

It 

3 


NOTE: Additional -CHANGE directive applications using combinations of sub- 

ordinate record-level directives are presented in section 3. 7. 4. 5. 


3-63 






" .. „ 







3,7«4»4»3 -QUIT reoord~leveI directive 
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P uypose * Ihe -GUIT record-level directive allows the user to tenhinate 
the generation of the -CHANGE identified new merobery optionally specifying 
the final old-member record to be copied to the new member. 

Forma t t QtllV^U] $ 

i (optional) specifies the integer relative position of the old- 

member- record that will be the last record copied -to the new 
member, if specified, i must be greater than old-Member 
record pointer P. Records P -h 1 through and including record 
i will be copied to the new member, if omitted, processing 
of the new-member generation is terminated immediately. 

Examples; 

Assume for both subsequent examples that the old member contains 
20 records and that the preceding record-level directive processed was the 
following: 

-INSERT 15 FROM-* $ 

(New record N1 card images) 

Example 1 ; Ihe following would result in termination of the -CHANGfi- 
initiated new-member generation. The last new-member record will be N1 . 

-quit $ 

Example 2 ; ihe following would result in old-ttiember records 16 and 17 
being the last records to be generated on the new member: 

-QUIT 17 $ 

Restrictions ; 

The -QUIT directive, if present, must be the last record-level direc- 
tive under the control of the -CHANGE directive, 

A value specification of operand i must be greater than that specified 
for operand i or j on any preceding record-level directive in the set. 


3. 7. 4. 5 Examples 

The following update processing phase examples Incorporate all of the 
member-level and record-level directives, it is assumed that each data 
source unit or new unit identified was established in the run-life data base 
via a preceding CREATE CS, ATTACH CS, or LOAD CS. 

Example 1 : A revised mode update is to be performed by using run-life 

unit OLDJET as the primary old unit. Unit OLDJET contains 20 members named 
HBM1 through MBN20 . 
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Unit NEWJBT is the run-life unit to be built (or rebuilt!^ NEMJBT Is 
f •** to receive the following members s 

MEM1 through MEM6 

MBM7 


MBM8 

MBM9 


MEMIO through MBM15 
HBNil6 


MBM17 through MEM20 
Thus# 

UPDATE OLDU=OLDJET Na»U«NEWJET SOURCE®* LIST»ESCA $ 

-COPY MEM1, MEH2, MEM3# KBM4, MEM5, MEM6 $ 

-CHANGE OLDM»M£M7 $ 

-INSERT 5 FROM®* $ 

.TRUE, .TRUE, 17.65D27 7278 (7.53 1E320) $ 

.FALSE. .FALSE, -lD+322 6920 (375.8E-1 2.270E+1 2) $ 
-DELETE 6,7 $ 

-QUIT 8 $ 

-ADDR OLDM=* NEWM®MEM8 F0RMAT=8H21,L*RS$ MNR=10 $ 

757 9329 .TRUE. 17.97 -3.18E03 $ 

14 723 .TRUE, 1E216 275E+10 18.327 $ 

1278 87 .FALSE. $ 

-ADDR OLDM=UNITFAN(UFMEM1), NEWM®MEM9 $ 

-COPY MEMIO, MEM11, MEM1 2, MEMi 3, MBM14, MBM15 $ 
-CHANGE OLDM®UNITFAN(UFMEM8) NEWM®MBMl 6 $ 

-DELETE 4 $ 

-DELETE 9 $ 

-QUIT 10 $ 

-COPY MEMI 7, MEMI 8# MEMI 9# MEM20 $ 

END* $ 


copied unchanged from unit OLDJBT 

rebuilt# using OLDJE]* Unit MBM7 as Its primary 
source member. HEM7 contains eight records; 
records 6 and 7 are to be replaced by user Input 
records . 

to be generated by using new Input records 

to be a renamed copy of run-llfe unit UNITfAN — 
resident member UFMeMI 

copied I'nchanged from unit OLD JET 

to be a rebuilt version of run-llfe unit UNITFAN 
resident member UFMBM8. Member UFMEM8 consists of 
10 records; records 4 and 9 are not to be copied 
to new member MEMi 6. 


copied unchanged from unit OLDJBT 


Example 2 ; A revised mode update is to be performed by using run-life 
unit STAT1 as the primary old unit. STAT1 contains 15 members named MEMI 
through MEMI 5. 
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Unit NEWSTAT la the run~Ilfe unit to be built end ia to receive the 
following memberat 

MEM1 through MEM4 copied unchanged from unit STAT1 

rebuilt by using system unit DAtA raeiftbef MfiMB 
as the primary source member. HEMg Is a card- 
IcAage formatted member containing seven cardsi 
cards 2 and 7 are to be replaced by user Input 
records. 


MEM6 

MEM7 and MEM8 
MBM9 through MENU 3 
Thus. 


to be generated by using new Input records 
renamed copies of unit STAT1 members MEM14 and MEM15 
copied unchanged from unit STATI 


OPDAtE 0LD0-STAT1 NEMU-MBWSTAT AtL SOURCE** $ 

-CHANGE 0LDM=DATA(MEMB) NEWM»MEM5 $ 

-INSERT 1 PRC*4«* $ 

THIS CARO IMAGE WILL BE NEW MEM5 RECORD 2 
-DELETE 2 $ 

-INSERT 6 PROM-* $ 

THIS CARD IMAGE WILL BE NEW MEM5 RECORD 7 
-ADDR OLDM-* NEWM-MEM6 PORMAT-1 6HA7,L, I,RS,RD,CS$ $ 

6HHEIGHT .TRUE. 89 + 7.93 17.16D27 (9.75.1E279) $ 

5HSPEED .PALSE. 94757 -1 .33E05 1 .36D-03 (-1 .7E02 0.92) $ 
-OMIT MBM14, MEM15 $ 

-ADDR OLDM-MEM14 NEWM-MEM7 $ 

-ADDR 0LEM-MEM15 NEWM-MEM8 $ 

END* $ 


NOTE; llie ALL keyword specification on the UPDATE CS above results In all 
primary old-unit STATI members that were not specified on a -OMIT directive, 
and that do not possess a name that is the scune as a new unit member gener- 
ated via a -CHANGE or -ADDR directive, being copied unchanged to the new 
unit NEWSTAT during the final update processing phase step. 


3.8 CONDITIONAL PROCESSING PLOW 
3*8.1 Overview 


The normal processing flow occurring in an ANOPP run is the sequential 
execution of each control statement in the user's input streams. Pollowinq 
execution of the last CS in a called secondary stream, the system executes 
the control statement that follows the CALL CS in the calling stream. Exe- 
cution of the ENDCS control statement, marking the end of the user's primary 
input stream, terminates the ANOPP run. 

The user, however, has the capability to deviate from normal sequential 
CS processing through error handling and branch control statements. 
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Controlling aubaequent CS prooessln^ following the ocourrenca of a 
systein **nonfatal" error »- Prior to execution of each control statement, the 
system sots an Internal nonfatal error flag to "off," if during the execu- 
tion of the CS or FM an abnormal but nonfatal condition occurs, the flag is 
set to "on." Documentation of error diagnostics of specific functional 
module (section 4) and ANOPP system (appendix C) iden t i f i es conditions that 
result in nonfatal errors. 

Following the execution of a functional module or a control statement, 
the system performs this sequence of stepsi 

Test the value of the internal nonfatal error flag. 

If "off," continue processing with next CS in stream. 

If "on" (error occurred), test value of system parameter JCON: 

If JCONa.TRUE. (set by user via SfiTSYS CS), continue process- 
ing with next CS in stream. 

If JCOM«. FALSE, (default value), search forward sequentially 
seeking a PROCEED CS: 

If a PROCEED CS is found, continue processing with the execu- 
tion of the CS following it* 

If the ENDCS ending the user's primary input stream is found 
first, terminate the job* 

If, at the time of the error, control was within a secondary input 
stream and JCONa*FALSB*, the search for a PROCEED CS will continue through 
the rest of the secondary stream* The search continues with the remainder 
of the calling stream beginning with the CS following the CALL CS until 
either a PROCEED CS or the run terminating ENDCS is found* 

Determining subsequent CS processing flow based on the current value of 
a us6r parameter* - The IP control statement allows the user to specify a 
logical condition of several types* The user also specifies a n£une that 
must be the label field value of another control statement in the same input 
stream* If the specified condition test is *TRUE*, processing will continue 
with the execution of the CS having the specified label name; if the condi- 
tion test is *FALSE*, processing continues normally with the next sequential 
CS in the stream* 

The GOTO CS performs the single function of transferring processing 
control unconditionally to the control statement having a specific label 
name* The CONTINUE CS is a control statement that may contain a label-name 
field and is used as the object of IP CS or GO^ CS processing, but it 
causes no other action to occur* 


3*8*2 GOTO CS 


Purpose t The GOTO control statement allows for an unconditional devia- 
tion from the sequential processing within an input stream* Procesr.ing will 
continue with the execution of the control statement having the label-field 
value specified. 
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PoriBat4 UalMl^lGOTO^labiiaae $ 

lAlMl ■ the- optional label name of this control statement 

latwiMe the required label name of another control statement within 
the same i ntmt-atream-wharfl-proeessing will continue 

Examplflaj L 

ENDST1 GOTO STBP3 $ 

GOTO STBP2 $ 

Restriction t Labname must be the label name of a control statement 
within the same input stream as the GOTO CS. 


3.8,3 IF CS 

purpose > The IF control statement permits an alteration in the flow of 
processing if a specified condition exists. The conditional statement is 
specified within parentheses. In the first form# the value of a user param- 
eter (or parameter array) is logically compared with the value of either 
another user parameter (array) or user-specified constant(s). In the second 
form# t)ie existence or nonexistence of a unit member is determined. If the 
condition within the parentheses is true# then processing continues with the 
control statement having the specified label; otherwise processing continues 
with the next control statement. 


Formats: 



l*hcl label name 

pAtamnAMe.| name of a user parameter whose value(s) is to be com- 
pared with the value(s) following the logical operator 

logical Operator a logical operator used in comparison of the two 

Values. Any logical operator is valid for compar- 
ing values which are type integer# real single pre- 
cision# or real double precision. (See table 1 in 
section 3,1.2.) The operators .EQ. and .NE. are the 
only valid operators for logical# complex single# and 
character string data types. For the .NE. operator# 
the results of element comparisons are combined with 
an OR condition. For all other operators# the 
results of element comparisons are combined with an 
AND condition. For the .NE. operator# only one ele- 
ment of the first array need be unequal to the 
corresponding element of the second array in order 


I 


>1 
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for the IP CS to yield a true condition* However^ 
for all other operators* every element of the first 
array compared to correapondinq elements of the 
second array must yield a true condition in order for 
the IP CS to yield a true condition* 

array of one or more elements of type numerical constant (I, RS* 

RD, CS), logical constant* or string constant* All elements 
must be of the same type. 


pstsntiaM 2 name of an existing user parameter array to be used in 
ooniparison 

unit name of data unit on which data member* mem, resides 

■eii name of data member 

RS flag indicating condition is true if unit (mem) exists* If 

unit (mem) exists as a data unit member and flag AS is 
indicated* a true condition results* If unit (mem) does not 
exist and AS is indicated* a false condition results. 

HAS flag indicating condition is true if unit (mem) does not exist. 

If unit (mem) does not exist as a data unit member and flag 
NAS is indicated* a true condition results* If unit (mem) 
exists and NAS is specified* a false condition results* 

labAtti the label of the control statement at which processing should 
continue if* the comparison of the two values results in a 
true condition. 


Examples; 

LABBL1 IP (A *GE. B) GOTO LABEL2 $ 

IP (D .EO* .TRUE.) GOTO LABEL1 $ 

IP (F *EQ, 6HFVAL0E) GOTO LABEL2 $ 

IP (G *GT. 10 20 30) GOTO LABEL1 $ 

IF (H ,EQ. .FALSE. .TRUE.) GOTO LABEL1 $ 

IP (PROC (SOURCE) AS) GOTO LABELS $ 

IP (PROC (SOURCE) NAS) GOTO LABEL2 $ 

• 

LABBL2 CONTINUE $ 

e ^ 

e 

LABBL3 CONTINUE $ 

Restrictions; 

Labname must be in the label field of a control statement within the 
same input stream as the IP CS. 

The data type of the second value array must agree with the value type 
of paramname^ . 

When comparing string constants of unequal length* trailing blanks are 
ignored* 
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The number of elements of the second-value array should agree with the 
number of elements of paramname^) if not, the condition is assumed false. 


3,8.4 CONTINUE CS 

Purpose I The CONTINUE control statement provides a no-aotion step 
within the input stream. It is used mainly with the IF C8 and/or GOTO CS to 
allow for an alteration in the flow of control-stream processing. The p.'o- 
oessing continues with the execution of the CS following the CONTINUE CS. 

Format s (labal^ICCMtllftlB $ 

label label field 

Example s 

LABEL1 CONTINUE $ 

Restrictions None . 


3.8.5 PROCEED CS 


Purpose s The PROCEED control statement marks the location within 
the input stream where ANOPP execution will continue if a nonfatal error 
condition occurs during the processing of a preceding cs or functional 
module and if the current value of system parameter JCON is .PAI>SE.. The 
PROCEED CS is a no-operation statement when encountered during normal 
sequential CS processing. 

Format s 

(label^]pR0CB8D $ 

label label field 

Examples 

ERROR1 PROCEED $ 

PROCEED $ 

Restrictions s 

During the forward search in the input stream of the system for a 
PROCEED CS, any CALL statements encountered are not processed. (The 
procedure-member resident input stream is not searches or expanded.) 

If the nonfatal error condition initiating the search for the 
PROCEED CS occurred during processing within a CALL'ed secondary input 
stream, and no PROCEED CS is found to exist in the remainder of that 
stream, the search will continue in the input stream that contained the 
CALL, beginning with the control statement following the CALL CS. 
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If the endCs control statement ending the user's primary input stream 
,31 is found before any PROCEED CS, the run will be terminated. 


3,B,6 EHaroplea 

The following examples illustrate conditional processing flow within 
input streame. 

Bxarogle 1 t The following input stream Illustrates the processing flow 
that will occur if a system nonfatal error occurs during the execution of a 
functional raodulet 

STARTCS $ 

SETSYS JCONo.TRUE. $ 

execute PMI $ 

SETSYS JCON-3. FALSE. $ 
execute FM2 $ 

ATTACH FM3UN1T/EPN3/ $ 

EXECUTE PM3 $ 

DETACH FM3UNIT $ 

GOTO LASTSTEP $ 

PROCEED $ 

ATTACH FM4UNIT/BFN4/ $ 

EXECUTE FM4 $ 

DETACH FM4UNIT $ 

LASTSTEP EXECUTE PM5 $ 

ENDCS $ 

Since system parameter JCON equals true when functional module PMI is 
executed^ processing will ccptinue with the SETSYS CS that follows it* 
regardless if a nonfatal error occurs during PMI execution. However, 
JCONs.PALSE. when functional module PM2 is executed. If no nonfatal error 
occurs in PM2, processing continues with the following ATTACH CS. If a 
nonfatal error does occur in FM2, processing will continue with the 
ATTACH CS following the PROCEED CS. 

Example 2: The following input stream illustrates conditional pro- 

cessing flow that occurs following the test of a logical condition based on 
the value of a user parameter: 

STARTCS $ 

♦ 

PARAM EXCOUN1^=0 $ 

REPEAT PARAM COUNTaEXCOUNT + 1 $ 

EXECUTE JET $ 

PARAM EXC0UNT<0UNT $ 

IP (BXCOUNT .NE. 5) GOTO REPEAT $ 

IP (JBTRSLT .EQ. .TRUE.) GOTO JETT $ 

EXECUTE JET9 $ 

GOTO BNDJBT $ 

JETT EXECUTE JET7 $ 

ENDJBT CONTINUE $ 
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Functional module jet is to be executed five times. The value of. user 
parameter COUNT is used both to control the specific function to be per- 
formed by PM JET and to count the execution repetitions. Following the 
fifth execution of PM JET, the value of logical user parameter JETRStT is 
tested. The value of JETRSLT is set internally in PM JET. If JETRSLT 
equals .TRUE.. PM JET7 will be executed next; otherwise..... PM Jet 9 will be 
executed. 


3.9 procedure-member INPUT STREAM 
3.9.1 Overview 


Procedure members are card-image formatted members whose records are 
valid control— statement card images. This set of CS card images is referred 
to as a secondary input streanu A secondary input stream may be called into 
execution via a CALL CS. Section 5 documents secondary input strefuus main- 
tained as part of the ANOPP system and available to the user for execution 
of specific noise prediction or utility-type functions. A secondary input 
stream residing on a procedure member may consist of any valid control 
statement card images except for the ANOPP CS. DATA CS. ENDCS CS, RSTRT CS, 
and STARTCS CS. Use of the END* input terminator card is also illegal 
within secondary input streams* 

More than one CALL CS in the same run may specify the same procedure 
member. The input stream resident on a procedure member may be altered 
during a run via the member regeneration capabilities of the UPDATE CS or 
Data CS. in addition, the field-replacement capability of the CALL CS 
allows the user to modify the procedure-member input stream prior to pro- 
cessing control being passed to the secondary stream. The first execution 
of a specific CALL CS during a run generates an executable version of the 
called secondary input stream, based on the current CS card-image content of 
the specified procedure member and on any field replacements also specified 
on the CALL CS, Any subsequent reexecution of the same CALL CS (as a result 
of Internal input-stream looping via IP CS or GOTO CS processing) will 
result in the same version of the input stream being executed. The initial 
execution of a CALL CS also results in a system edit phase bein./ performed 
on the secondary stream. Each CS is examined for correct syntax. A CS edit 
phase error results in run termination. 

The user is provided a CALL CS capability to perform text modification 
on the field contents of the CS card images residing on the specified proce- 
dure member. The modified ver*’*on of the secondary input stream is then 
examined during the system CS edit phase. Provided no edit errors are 
encountered, the system builds the form of the secondary input stream that 
will be executed each time this specific CALL CS is processed during the 
run. 


The field-replacement feature of the CALL CS requires the user to 
specify one oi more old field values (of any valid CS data type including 
the type N name of a control statement) and, for each, a new field value, 
also of any type. 

The system will examine the individual field content of each CS card 
image on the procedure member. Wherever a specified old value is found it 



will be replaced by the matching specified new value. The rebuilt control 

statements will reside on a system-maintained call CS 

of. the CALL CS specified procedure member is never altered via a CALL CS. 

Typical use of the field-teplacemeflt feature would be the 
of a liLary file name, data unit name, functional module name, “^®’^ 

parameter value within a secondary input stream that performs a commonly 
required sequence of AKOPP processing steps. 


3.9.2 CALL CS 

purpose: the CALL control statement allows the user to transfer wn^^ 

proc essiS ^ o ntrol to a secondary input stream, exe^ion of the 

last CS in the called stream, run control continues with the CS following 
the CALL control statement. 

The initial processing of a specific CALL CS establishes the secondary 
input stream to be executed by this and all subsequent ®f ^ 

same CALL CS in the run. The content of the executable input stream is 

CS ctd im.... r..idln, on . .peclti.d run-llf. proc.du« m.n- 
ber and any field replacements specified on the CALL CS. 

A field-replacement specification consists of an old value wd a corre- 
.ponding n« ..in.. fl.ld of .ny CS e,rd i«.g. t..ldln, on 

dot* «wnb.r that Hatches a speoltUd old valoe .111 ^ 
responding new value on the executable version of the secondary input 

stteam# 

a ayst«. CS edit phase Is petforoed prior to the Initial exertion o£ a 
ChtL’ed secondary Input stream, any CS format or syntax error will result 
in run termination. 


Format: 

Clebel^tCALi^dun(pmn) (^ldvalue^=newvalue^ . . .^ldealtte,j««new<ralueg|l $ 


label label name 


dun 

pmn 


name of the run-life unit on which pi.m resides 


ame of the procedure member containing control statement °«d 
images to be used in the generation of the secondary input stream 

4>n tSA AVACUted 


oldsalue 


(optional) the exact field value which, if found to ocwr on a 
pmn resident CS card image, is to be replaced with the cor- 
responding new value. The old value may be of any t^e 
valid on any control statement, including the name of a con- 
trol statement which is a type N (Name) data type. (See 
table 1 in section 3.1.2.) 
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newvaltte 


the cs imaqe field to replace each occurrence of old value » 

The new value may be of afiy type valid on a control state- 
ment and does not have to be the same ^s the type of the 
old value. 

Examples t 

Example 1 1 The following cs will call into execution the secondary 
input stream consistin<] of the card images residing on data unit UtJI. proce- 
dure member MEM3. with no field replacement involved: 

LABEL1 CALL UNI (MBM3) $ 

Example 2 ; Assume that procedure member NOISBUN. residing on run-life 
unit TBLTEST, contains the following card images: 

LOAD/SEFM/ $ 

PARAM INDX«0 $ 

REDO PARAM TBL1NDX»INDX+1 $ 

EXECUTE PMNAHE $ 

IP (T8LINDX ,EQ. REPEATS) GOTO PINI $ 

PARAM INDX«TBLIN0X $ 

GOTO REDO $ 

PINI DROP /SEPN/ $ 

The user wishes to execute functional module JET1 10 times. The JBT1*s data 
base requirements are contained on library file JETLIB. The following 
CALL CS would build and execute the desired secondary input stream: 


CALL NOISEUN( TBLTEST) /SEPN/=/JETLIB/ PMNAME=JET1 REPEATS=10 $ 

Following the system's performance of the CALL CS specified field replace- 
ments, the executable version of the secondary input stream would be as 
follows (the new field values are underlined): 

LOAD /JETLIB/ $ 

PARAM INDXaO $ 

REDO PARAM TBLINDX*INDX+1 $ 

EXECUTE JET1 $ 

IF (TBLINDX .EQ. 10 ) GOTO PINI $ 

PARAM INDX=TBLINDX $ 

GOTO REDO $ 

PINI DROP /JETLIB/ $ 

Restrictions: 


Specified old values must be an exact specification of an entire con- 
trol statement field. 

Only the Initial processing of a specific CALL CS in a run results in 
the generation and editing of the secondary input stream to be executed. 
Subsequent reprocessing of the same CALL CS, regardless of any modifications 
made to the signified procedure member's content^ will execute the same 
secondary stream as did the initial processing of the CALL CS. 
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The procedure-member resident secondary input stream may not Include 
arty ANOPP CS» DATA CS, RMDCS CS, RSTRT CS, STARTCS CS, or END* Input termi- 
nator card Images. 


3.10 CHECKPOINT/RESTART 
3.1 0.1 . OvecJuiew 


•Hie ANOPP system provides the capability to establish checkpoints 
within an input stream(s) of a run and to restart that run in a subsequent 
job without reprocessinq the input stream statements that preceded a spe- 
cific checkpoint in the initial run. fhe intent of checkpoint/restart is to 
save the run environment in the event of either a planned or unplanned 
interruption in an ANOPP execution. This capability may be used to protect 
against system crashes or to halt a run's execution for examination of 
intermediate data without losing execution time or data base characteris- 
tics*. Depending on the results of that examination, the user may specify 
that the operating environment that existed at any specific checkpoint be 
reestablished and execution continued_ 

The checkpoint run.- A checkpoint run is any ANOPP run during which a 
CKPNT CS is executed.. During the execution of CKPNT i < the system writes 
to a checkpoint file the necessary internal system and run-life data base 
information required to recreate this run's current operating environment 
for use in a subsequent restart run. — 

The checkpoint/restart file .- During each checkpoint run the user must 
ensure that an external sequential checkpoint file is assigned to the job. 
This checkpoint file must be permanently retained in the external system 
following job termination if it is to be used as the restart file in an 
ANOPP restart run application. The checkpoint/restart file may reside on 
tape or rotating mass storage. 

The checkpoint/restart file structure is divided Into primary divisions 
called cycles. Bach cycle is referenced by the Integer number of its 
sequential position on the file. Cycle 1 would be the first cycle Written 
to the file resulting from the first CKPNT CS executed in the checkpoint 
run. Any subsequent CKPNT control statement execution in the tun would 
generate another cycle on the checkpoint/restart file. Whenever a 
checkpoint-file cycle is generated during a run, a report is printed identi- 
fying the cycle number, the current run-life data units, and other check- 
point status Information that will assist the user in selecting his future 
restart options. In a subsequent restart run the user specifies at what 
position (checkpoint) he wishes to restart his run within the initial pro- 
cessing stream of the checkpoint run. 

Each cycle of the checkpoint file contains the necessary Information 
to preserve the current operating environment that existed at the time its 
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generating OCWlT CS was executed. The cycle information contains the 
Collowing: 


All required internal system tables, including those that contain: 

User parameter names and values 

Run-control (initialization and system) parametec values 
Run-life data base directories 

A copy of each nonarcblved. run-life unit and its members, including 
system unit DATA 

A list of the archived run-life units 

The external name urder* Which the sequential checkpoint file is 
assigned to a user's, job must also be established within the run. The user 
may specify the external name of the checkpoint file via the AtlOPP CS or 
RSTrT CS specification of initialisation parameter dcRHT. If not specified 
in— this manner, the system uses the default name of CPPlbE. 

The CKPMT CS.- The CKPRT CS is used to establish a Checkpoint within 
any input stream in a user's run. The CKPNT CS is not automatically exe- 
cuted when encountered during the processing phases of ah ANOPP run. The 
CKPNT CS is treated as inactive (a no-operation CS) if logical system param- 
eter JCKPMT is set to system default value .FALSE, at the time that 
the CKPNT CS is processed. This allows the user t© insert CKRNT control 
statements at potential restart locations within the input streams and con- 
trol activation and deactivation via system parameter JCKPNT. A CKPNT CS 
may contain an optional specification of the keyword STOP*, if specified on 
an executed CKPNT CS, the ANOPP run will-b^ terminated following generation 
of the checkpoint-file cycle. 

System parameter JCKPNT.- The value of JCKPNT controls all checkpoint 
(CKPNT CS) processing in ANOPP runs* Only when the current value of JCKPNT 
*TRUe^ is a CKPNT CS executed, resulting in the generation of a new 
checkpoint-file cycle. If the user specifies the name of an external check- 
point file via initialization parameter CKPNT on an ANOPP CS or RSTRT CS. 
the initial value of JCKPNT is set to .TRUE.. The user may also activate 
and deactivate checkpoint processing during his runs via SETSYS CS specifi- 
cations of parameter JCKPNT values. 

The restart run.- Each ANOPP restart run is initiated via the special 
RSTRT control statement. The RSTRT CS must be the first card in the run 
input deck and provides run-initialization capabilities similar to those 

provided by the optional ANOPP CS in nonrestart runs. The RSTRT CS performs 
the following: 

Identifies the run as an ANOPP restart application 

Indicates which previous checkpoint run is to be restarted at what 
checkpoint 

Allows for the change of previous initialization or system parameter 
values 

The optional RSTRT=« keyword parameter of the RSTRT control statement is 
used to specify the name under which the user's external restart file is 
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assl^ndd to-hiti job* Xf omitted, the system assumes that the user's restart 
file has the nam e rs pXLB. 


e 


the RSCyCL* keyword parameter of the RStRf CS la used to specify the 
Integer number of the cycle on the restart file to be used to restart the 
previous checkpoint run*— If omitted, the last cycle generated on the file 
will be Used* 

Restart-run initialisation *- iJie initialization phase of a restart run 
begins when the RS1!RT CS is encountered* ihe RSTRT CS- specified restart 
file and cycle are accessed* Ihe operating environment preserved by the 
specified cycle is reestablished* Ihe initialization steps are as follows; 

(1) System and initialization pareuneters are assigned their check- 
pointed values or are assigned new values if specified on the l^fRi: CS* 

(2) Ihe checkpointed run-life data base is reestablished* Each non- 
archived data unit and its members will be copied from the restart file to 
an external file with the same name as the one it resided- on at checkpoint 
time* If the user has an external file assigned to the restart job that 
matches a file name of a checkpointed unit stored on the restart file, that 
external file will receive the copy? otherwise, the system will use a 
scratch (temporary) file of the same name* the system unit DATA is regener- 
ated by using checkpoint cycle Copies* No archived data unit file that 
existed in the checkpointed run— life data base will be regenerated* The 
user has the responsibility of ensuring that the external files on which 
archived units reside are assigned -.o his restart job. The user must ensure 
that any library files required by subseqtient restart-ruh processing are 
externally assigned to his job* 

(3) The user parameter tables and data unit directory are reestablished 
with checkpointed values* 

(4) System parameter JRSTRT is set to .TRUE,, indicating. .that_ANC®P 

restart run processing is to occur. 

Following initialization, >he next processing step depends on whether 
the User has supplied a new primary input stream in his run input deck. If 
the RSTRT CS was the only card image in the input deck, run processing 
resumes with the execution of the control statement within the initial-run 
input stream which followed the CKPNT CS that generated the applicable 
checkpoint (restart) cycle. 

An inserted primary input stream can be processed either prior to or 
instead of the resumption of checkpointed input stream processing as 
described above* An inserted primary input stream may not contain a CKPNT 
control statement. 

The value of logical system parameter JRSTRT upon completion of the 
inserted input stream (BNDCS) processing determines whether the run will 
terminate or resume processing the checkpointed input stream* The JRSTRT is 
set to .TRUE, during restart-run initialization, if the user has changed 
its value to .FALSE., and the ENDCS is processed, the run will be terminated 
at that point. If JRSTRT is equal to .TRUE, at ENDCS process time, run 
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follow, :•* 

3.1 0«2 caci»Sft Pfi 

pointT^ithin a wee^ * potential ohacJc- 
eter JCKPNl^.tRUE., each execuUorgeLiLrr^!*^ P*""- 

checkpoint file. The checkpoint cycle * P>^®‘*eaignated 

life data base information required to otea^tw» system and run- 

ronment for use in Subsequent \estart runs? current operating envi- 

lormatj tlabel^ldtPStt^fOPj $ 

Ishsl label name 


STOP 


°^thr?in^mrtermiLtrfiliwlM th 

checkpoint file cycle preset vinf t-h^ generation of the 
ing environment. ^ current-run operat- 

Examples: 


labeli ocpnt $ 

CKPET stop $ 

Restrictions The CKPNT CS ia vaH/? 

• primary input atrnam Ina.rtad in an n^P^natTrt 

3.10.3 RSTftT rg 

reestl^uSf; e^heS^Lteroper^tinH^^ ® 

the specification or omission S ^<3®"tifies, through 

nal restart file and the checkpoint^la If,' exter- 

environment to be rbestablisLrifp?^^e?v^3."^® «»« operating “ 

tion JUd values for initialisa- 

eters subject to RSTRT CS specifiwUoi. presents those param- 

Pormatt 


I -value. 


.^araanaae^-valtte^l $ 


°^uTn} 

to the user's job. if omltfcoii D^cm ^ currently assigned 
8 3 on. If omitted, RSTRT«RSP1LE is assumed. 




RSc?Cl>*cn 


par<uuta«d 


'Value 


optional keyword speolfication of the Integer checkpoint 
cycle number on the restart file from which the oporatinq 
environment is to be reestablished at the initiation of 
this run* If omittedji_the last cycle on the restart file 
is-used* 

optional specification of the name of a run-control initial- 
isation or system parameter whose checkpointed value is to- 
be changed. (See table $►) 

the new value to be assigned the specified paramname at- 
initiallzatlon of the restart run 


Example St 
ftSTRT $ 

RSTRl' RSTRlVRPtLElM LE»GIf*30000 CKP»f>«NEWRFLE $ 
RSfRt-RSCVCLE»3,..JCECHCM.IIU}£, $ 

Res trictiona t 


RSTRT CS is Valid only as the first CS and^ 
a restart run input deck. 


optionally# the only CS in 


The specified or assumed external file name 
may not be the same as the external file name of 
or run-Ufe data-unit file used within the run. 


(sefn) of the restart file 
any seguential library file 


j.tu.4 Examples 

exantt>le 1; Por the following example, the run is ini- 

processing active via the initialization parameter 
CKPOT specification on the ANoPP CS; system parameter JOCPHt is automati- 
cally initialized as .TRUE.; and external sequential file JEtPlLE is identi- 
fied as the checkpoint file; 


ANOPP OCPMlJ-JETPILE $ 

STARICS $ 

CPI ckp»Jt $ 

e 

IP (KfiyiTEM .EQ. .TRUE.) GOTO CP2 $ 
Sfitsyg JCKPMD-.PAtSE. $ 

CP2 CRPtM Slop $ 

e 

e 

SBTSYS JCKP8t».TRUE. $ 

CP3 CKPRT STOP $ 

e 

e 

ENDCS $ 
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ORIGINAL mCB U 
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TAPf^E 5.- RSTRT CS IN ITIALWATIOH-AND^ SYSTEM PARAMETERS 


Parameter 

Parameter 

Description 

Value 


Default 

name 

type 

Type 

Range 

value 

ACCOUNT 

System® 

Controls accumulation of cost-accounting 
dat 4 associated with each functional 
module or executive processor 

ACCOUNT^ .TRUE* - accumulate accounting data 
ACCOUNT*. FALSE. - do not accumulate 
accounting data 

Logical 

.TRUE. 

.FALSE. 

.FALSE • 

cKm 

initiali- 

sation 

Identifies name of external checkpoint file 
to be generated during run. Its speci- 
fication also results in system parameter 
JCKpNT being initialized as .TRUE.# auto- 
matically activating checkpoint process- 
ing in the run 

Alphanumeric 
name of 
seven 

characters 
or less 


CPFILE 

JECHO 

System® 

Controls printing of CS card image upon 
validation in primary edit phase (primary 
input stream editing) and secondary edit 
phases (procedure member-editing) 

JECHO* .True. - print CS card images 
JECHO* .FALSE. - do not print CS card 
images 

Logical 

.True. 

.FALSE. 

.FALSE. 

JLOG 

System® 

Control printing of CS card images upon 
execution in executive processing 
phases 

JLOG* .TRUE. - print CS card images 
JLOG*. FALSE. - do not print CS card 
images 

Logical 

.TRUE. 

•FALSL. 

.TRUE. 

LHNGL 

initiali- 

zation 

Controls size (number of computer words 
within user's job field length) assigned 
to global dynamic stores (GDS) for this 
ANOPP run 

Tnteger 

»3000 

12000 

NAETD 

initlall* 

eatlon 

Controls number of table -directory entries 
initially allocated for this ANOPP run 

Integer 

1 

1 

10 

nAeud 

Inltiall- 

aatlon 

Controls number of data unit directory 
entries initially allocated for this 
ANOPP run 

Integer 


25 

NLPPM 

Initiali- 

zation 

Controls number of lines per page to be 
used for ANOPP printed output during 
this run 

Integer 

>15 

48 

NOGO 

Initlall* 

aatlon 

Determine if ANOPP run is to be limited 
to primary-edit-phase execution only 

N0G0**TRUE. - primary-edit-phase-only 
run 

NOGO*. FALSE. - normal ANOPP run 

Logical 

.TRUE. 

.PALSF. 

.FALSE. 


*08«ge discussions for each of the initialisation parameters are presented in section 3t1#3 
and for each of the system parameters in section 3.2. 



Checkpoint CPI will be exeoute4. However, the next checkpoint to be 
'»• executed depends on the result of the IF CS test* checkpoint CP2 will be 

executed If logical user param KBYIf6M».TR0S. followed by run termination 
via the S'^P keyword specification on the CKPNT CS* Otherwise, the SETSYS 
CS preceding checkpoint CP2 will deactivate checkpoint processing and CP2 
CKPMT will be Ignored* In this case, checkpoint CP3 would subsequently be 
executed and terminate the run* 

Checkpoint run example 2 t For the following example, the run would be 
initialized with checkpoint processing Inactive (system param JCKPNT set to 
defaul-t value-~»PALSB*) * Checkpoint CKP1 would not be executed* 

STARTCS $ 

CKP1 OCPHT $ 


SETSYS JCKPN‘P»*'fRUE*-$ 

CKP2 CKPNT $ 

ENDCS $ 

The SETSYS CS specification of JCKPNT«.TRUE* would initialize check- 
point processing In the run* The checkpoint file used will have the default 
external name of CPFILB* Checkpoint CKP2 will be executed, followed by 
continued run processing since the CKPNT CS keyword STOP was not specified* 

Restart run example 1 ; Assume that the following CS 1s the only card 
image In the user's input stream, that this Is a restart of the run shown in 
checkpoint run example 1 above, and that the CKPNT CS labeled CP2 was the 
last checkpoint executed In that run: 

RSTRT RSTRT»jeTPILE CKPNT=>NEWCPP $ 

The operating environment preserved by CKPNT CP2 will be reestablished 
since RSTRT CS keyword RSCYCL was not specified and the last cycle found on 
the restart file Is used by default* Since the RSTRT CS also specifies 
Initialization pareuneter CKPNT, checkpoint processing will also be Initially 
active during this restart run* Processing will resume with the execution 
of the control statement In the Input stream of the checkpointed run that 
follows the CKPNT CS labeled CP2* Subsequent execution of CKPNT control 
statements will result In new checkpoint cycles being generated on check- 
point file NBWCPF* 

Restart run example 2 : Again, assume that the following Is a restart 

of the run shown In checkpoint run example 1 above* Since the RSTRT CS 
keyword RSTRT* is not specified, the system assumes that the user's restart 
file is assigned to this job by the default external file name RSFILE* 
Keyword RSCYCL specified that cycle 1 on the file, generated by the CKPNT CS 
labeled CPI in the checkpointed run, will be used to reestablish the operat” 
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RSTRT RSCVCI.-1 JECHt>. FALSE. $ 

STARTCS $ 

execute PhJ^T $ 

IP (PMRESULT ,BQ. .TRUE.) GOTO ENOXT S 
SETSYS JRSTRT».P;VLSE. $ 

ENDIT EMDCS $ 

the inaerted"primary^lnput^rtM execution of 

ENDCS ending ?Je ?nLi?e!l st^er the execution of the 

system p.irameter JRSTRT: ' check the current value of 

If JRSTRT». FALSE., restart run processing terminates. 

processiJg'^Jm'^’contiSie^Uh tL''MecitIon"of"tht^L''f 
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4 AMOPP FUNCTIONAL MODULES 


Thlfl septlon describes the functional modules, provides the Instruct 
tions for their use, documents the Inputs required for execution, and 
deacribaa the reaultlnq outputs. Each functional module la Implemented 
uslnq the EXECtPTE CS as documented in section 3.4.^. 

The functional modules described In this section are documented with 
internal documentation that Is maintained In the FORTRAN source code. For 
ease of use. If la arrahqed In accordance with the format described In 
figure 1«. When questions arise concerning the operation of a functional 
module, the source code should be consulted for the exact requirements and 
results. iSils Is done to ensure that the correct documentation be available 
for each version of the program In existence. The level described in this 
manual Is Level 03/nn/nn , 


4.1 OVERVIEW 

The functional modules installed In ANOPP fall into seven categories: 

1 . Aircraft flight dynamics 

2. Propagation effects 

3. Source noise parameters 

4. propagation 

5. Received noise 

6. Utilities 

7 . Noise sources 

The ANOPP User* s Manual documents modules In the same order as the ANOPP 
Theoretical Manual (ref. l ) documents prediction methods, since these 
manuals are meant to be oonpanlon volumes. 
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1111 
0 2 4 6 

PURPOSE - short description of the functional module (1-2 sentences) 

AUTHOR - Initials and level numbert such as LOl/00/00 

INPUT 

USER PARAMETERS 

Naitiex - description • default value 


Namer, - description - default value 
MEMBERS AND TABLES 

DATA UNIT(DATA MEMBER) - short description of data requirement 
OUTPUT 

SYSTEM PARAMETERS 
Name •> description 
USER PARAMETER - same as for INPUT 
MEMBERS AND TABLES 

DATA UNIT(DATA MEMBER) - Short description of data requirements 
DATA BASE STRUCTURES 

DATA UNIT(DATA MEMBER) - complete description of data and required 

format 

ERRORS 

NON-FATAL - description of errors that are possible within the 
functional module. 

FATAl - functional modules are requested to not use fatal errors. 
In the event this Is not followed they must be documented 
In this section. 

LDS REQUIREMENTS - describes the amount of local dynamic storage 

required by this module. 

GDS REQUIREMENTS - describes the amount of global dynamic storage 

required fcr this module. 


Figure 1.- ANOPP functional module prologue format. 


OfilQlNAL PAGE la 

OF poon quAUTV 

4.2-^IRCRAFT FLIGHT DYNAMICS 
4.2.1 Atffiospherjc Jtodulg (ATM) 


PURPOSE - BUILD TABLE OF ATMOSPHERIC MODEL DATA AS FUNCTIONS. 
OF ALTITUDE- 

AUTHOR - SWP(L03/00/00) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS TYPE DEFAULT 

OELH ALTITUDE INCREMENT FOR OUTPUT RS 100. 

M (FT) 

HI GROUND LEVEL ALTITUDE RS 0. 

REFERENCED TO SEA LEVEL 
M (FT) 

lUNITS INPUT UNITS CODE A 2HSI 

=2HSI , INPUTS ARE IN SI 
UNITS 

“7HENGLISH, INPUTS ARE IN ENGLISH 
UNITS 

NHO NUMBER OF ALTITUDES FOR OUTPUT I 1 

ATMOSPHERIC FUNCTIONS 

PI ATMOSPHERIC PRESSURE AT RS 101325. 

GROUND LEVEL N/M**2 (LBF/FT**2) 

IPRINT PRINT CODE FOR FORTRAN WRITE I 3 

0 NO PRINT DESIRED 

1 INPUT PARAMETER PRINT ONLY 

2 OUTPUT PRINT ONLY 

^ 3 BOTH INPUT PARAMETER AND OUTPUT PRINT 

MEMBER 

ATM( IN ) 

TEMPORARIES 

member 

SCRATCH! TAB! ) 


OUTPUT 

SYSTEM PARAMETER 

NERR EXECUTIVE SYSTEM PARAMETER FOR ERROR ENCOUNTERED 
DURING EXECUTION OF A FUNCTIONAL MODIILZ. NERR 
SET To .TRUE. IF ERROR ENCOUNTERED. 

MEMBER 
ATM( TMOD ) 
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Atro&spherlc Module (ATM) 


DATA BASE STRUCTURES 

ATM( IN ) CONTAINS DATA INPUT TO ATH IN FOLLOWING FORMAT 


RECORD FORMAT DESCRIPTION 


1 3RS ALT. TEMP, RELATIVE HUMlOIlY 

(ALTITUDE, "ALT"* IS 
REFERENCED TO SEA LEVEL AND 
SHOULD NOT BE LESS THAN USER 
PARAMETER HI.) 


ALTITUDE UNITS M(FT) 

TEMPERATURE UNITS KELVIN(RANKINE) 

RELATIVE HUMIDITY PERCENT 

SCRATCH( ; ) 

TEMPORARY TWO-DIMENSIONAL TYPE 1 DATA TABLE 
INDEPENDENT VARIABLES 

1. ALTITUDE 

2. ORDERED POSITION 

DEPENDENT VARIABLES IN FOLLOWING ORDER 
TEMPERATURE 

humidity 

ATM( TMOD ) OUTPUT TWO-DIMENSlONAL TYPE 1 DATA TABLE OF 

ATMOSPHERIC MODEL VALUES IN DIMENSIONLESS UNITS 
INDEPENDENT VARIABLES 

1. ALTITUDE (REFERENCED TO GROUND LEVEL) 

2. ORDERED POSITION 

DEPENDENT VARIABLES IN FOLLOWING ORDER 
PRESSURE 
DENSITY 
TEMPERATURE 
SPEED OF SOUND 
AVERAGE SPEED OF SOUND 
HUMIDITY 

COEFFICIENT OF VISCOSITY 
COEFFICIENT OF THERMAL CONDUCTIVITY 
CHARACTERISTIC IMPEDANCE (RHO*C) 

ERRORS 

NON-FATAL 

1. USER PARAMETER NHO IS OUT OF RANGE 

2. MEMBER CONTAINING INPUT DATA NOT AVAILABLE 

3. LOCAL DYNAMIC STORAGE INSUFFICIENT 

4. ERROR OCCURRED IN TABLE BUILD ROUTINE WHICH PREVENTED 
THE BUILDING OF A TABLE, 

5. MEMBER CONTAINING INPUT DATA INVALID 
FATAL - NONE 


ORIt'NAL 

OF POOR QUALITY 


4.2«2 Geometry Module fflEOI 


PURPOSE - TO CALCULATE THE SOURCE TO OBSERVER GEOMETRY 

AUTHOR REG(L03/00/00) 

WKB(L03/00/01) 

WKB(L03/00/03) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS 


DEFAULT 
SI UNITS 


AW REFERENCE AREA OF THE AIRCRAFT 

(EXAMPLE. WING AREA). 

M**2 (FT**2) 1,00 

CTK CHARACTERISTIC TIME CONSTANT 1.00 

DELDB LIMITING NOISE LEVEL. DOWN FROM THE PEAK(DB) 20. 
MASSAC REFERENCE MASS OF THE AIRCRAFT. 

KG (SLUGS) 416.8 

START INITIAL FLIGHT TIME TO BE CONSIDERED. S 0. 

STOP FINAL FLIGHT TIME TO BE CONSIDERED* S 9999. 

DELT RECEPTION TIME INCREMENT, S .5 

OELTH MAXIMUM POLAR DIRECTIVITY ANGLE LIMIT, DEG 10.- 
ICOORD OUTPUT OPTION 


0 NEITHER BODY NOR WIND OUTPUT REQUIRED 3 

1 BODY AXES OUTPUT REQUIRED 

2 WIND AXES OUTPUT REQUIRED 

3 BOTH WIND AND BODY AXES OUTPUT REQUIRED 

DIRECT -.FALSE., INTERPOLATE FROM FLI(PATH) .FALSE. 

OBSERVER RECEPTION TIMES AND 
GEOMETRY BASED ON USER 


PARAMETERS START, STOP, DELTH, 
AND DELT 


-.TRUE. .^CALCULATE OBSERVER RECEPTION 

TIMES AND GEOMETRY BASED ON THE 
EXACT FLIGHT TIMES AS READ FROM 
^ UNIT MEMBER FLI(PATH) 

IR-RINT OUTPUT PRINT OPTION 3 

0 NO PRINT DESIRED 

1 INPUT PRINT ONLY 

2 OUTPUT PRINT ONLY 

3 BOTH INPUT AND OUTPUT PRINT 

lUNlTS UNITS FLAG FOR BOTH INPUT AND OUTPUT 2HSI 

2HSI METRIC UNITS 

7HENGLISH ENGLISH UNITS 


MEMBERS 

FLI(PATH) 
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Geometry Module (GEO) . 



GE0( SOURCE) 
OBSERV(COORO) 


- NEEDED IF OTHER THAN BODY AND WIND AXES 
SYSTEMS ARE TO BE OUTPUT. 

. GEOMETRY OF OBSERVERS 


I OUTPUT 

USER PARAMETERS 

GEOERR GEOMETRY ERROR FLAG 

0 NO OUTPUT WITHIN RANGE 

1 SUCCESSFUL COMPLETION 



MEMBERS 

GEO(BODY) - GEOMETRY ASSOCIATED WITH BODY AXIS SYSTEM 

GEO(WINO) - GEOMETRY ASSOCIATED WITH WIND AXIS SYSTEM 

GEO(XXXX) - GEOMETRY ASSOCIATED WITH USER SUPPLIED SOURCE 

COORDINATE SYSTEM(S). THE MEMBER NAME(S) XXXX 
IS GIVEN BY THE SECOND ELEMENT OF EACH RECORD 
FROM UNIT MEMBER GEO( SOURCE). THE NUMBER OF 
RECORDS IN GEO( SOURCE) DETERMINES THE NUMBER OF 
GEO(XXXX) UNIT MEMBERS. IT IS IMPORTANT THAT 
THE SECOND ELEMENT OF EACH RECORD IN 
GEO(SOURCE) BE UNIQUE TO ALLOW EACH COORDINATE 
SYSTEM TO HAVE ITS OWN MEMBER NAME ON UNIT GEO. 



TEMPORARY 

MEMBERS 

SCRATCH(FLITAB) - TABLE OF FLIGHT DATA CREATED AND USED 
BY GEO 

SCRATCH( FLIGHT) - TEMPORARY MEMBER CONTAINING OUTPUT DATA 
PRIOR TO ARRANGING IT ONTO THE OUTPUT 
DATA MEMBERS 



DATA STRUCTURES 

ATM(TMOD) - TYPE 1 DATA TABLE OF ATMOSPHERIC MODEL CONTAINING 
EIGHT FUNCTIONS OF ALTITUDE. DEPENDENT VARIABLES 
ARE IN THE FOLLOWING ORDER BY ORDERED POSITION 

1. ATMOSPHERIC PRESSURE 

2. DENSITY 

3. TEMPERATURE 

4. SPEED OF SOUND 

5. AVERAGE SPEED OF SOUND 

6. RELATIVE HUMIDITY 

7. COEFFICIENT OF VISCOSITY 

8. COEFFICIENT OF THERMAL CONDUCTIVITY 

9. CHARACTERISTIC IMPEDANCE 
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FLI(PATH) - INPU’’ MEMBER IN lORS FORMAT. EACH RECORD CONTAINS 
THE TRAJECTORY DATA IN THE FOLLOWING ORDER 
WO' - FLIGHT TIME 

W0..W - A/C X LOCATION (EARTH FIXED) 

WORD 3 - Y LOCATION (EARTH FIXED) 

WORD 4 . Z LOCATION (EARTH FIXED) 

WORD 5 - PSI EULER ANGLE (EARTH FIXED - BODY) 

WORD 6 - TH EULER ANGLE (EARTH FIXED - BODY) 

WORD 7 - PHI EULER ANGLE (EARTH FIXED - BODY) 

WORD 8 - PSI EULER ANGLE (BODY - WIND) 

WORD 9 - TH EULER ANGLE (BODY - WIND) 

WORD 10 - PHI EULER ANGLE (BODY - WIND) 

GEO(SOURCE)- INPUT MEMBER CONTAINING DESCRIPTIONS OF SOURCE 
COORDINATE SYSTEMS FOR WHICH OUTPUT IS REQUIRED 
THE MEMBER CONSISTS OF RECORDS IN I.A8.6RS.A80 
FORMAT WHERE 

ELEMENT 1 - SOURCE COORDINATE INDEX 
ELEMENT 2 - SOURCE COORDINATE NAME 

(THIS NAME WILL BE THE MEMBER NAME 
XXXX USED ON UNIT MEMBER GEO(XXXX)) 
ELEMENT 3 - X OFFSET FROM THE BODY ORIGIN 

ELEMENT 4 - Y OFFSET FROM THE BODY ORIGIN 

ELEMENT 5-2 OFFSET FROM THE BODY ORIGIN 
ELEMENT 6 - PSI EULER ANQLE(BODY - SOURCE) 

ELEMENT 7 - TH EULER ANGLE(BOOY - SOURCE) 

ELEMENT 8 - PHI 

ELEMENT 9 - SOURCE COORDINATE DESCRIPTION 


GEO(XXXX) - 

THE FORMAT OF GEO(XXXX) IS AS FOLLOWS: 


RECORD WORD 
1 

1 

2 

3 

4 

5 

6 


DESCRIPTION 

RECORD FORMAT IS I.3RS,I,RS 
OBSERVER INDEX FOR FIRST OBSERVER 
X COORDINATE OF OBSERVER 
Y COORDINATE OF OBSERVER 
Z COORDINATE OF OBSERVER 
NUMBER OF RECEPTION TIMES ASSOCIATED WITH 
THIS OBSERVER (ASSUME VALUE IS N) 
OBSERVER'S HEIGHT 


2 RECORD FORMAT IS *RS 

1 

. RECEPTION TIMES FOR CURRENT OBSERVER 
. INDEX 
N 


r 

i . ' 
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RECORDS 3 THROUGH H+2 CONTAIN GEOMETRY DATA FOR EACH 
RECEPTION TIME. RECORD 3 CONTAINS GEOMETRY DATA FOR 
THE FIRST RECEPTION TIME, RECORD 4 FOR THE SECOND 

reception time,.*, record n+2 for the n th reception 

TIME. 

3 RECORD FORMAT IS *RS 

1 DISTANCE OF SOURCE FROM OBSERVER 

2 EMISSION TIME 

3 DIRECTIVITY ANGLE 

4 ELEVATION ANGLE 

5 AZIMUTH ANGLE 

4 REPEAT OF RECORD 3 FOR SECOND RECEPTION TIME 


N+3 RECORD FORMAT IS *RS 

1 OBSERVER INDEX FOR SECOND OBSERVER 

2 X COORDINATE OF OBSERVER 

3 Y COORDINATE OF OBSERVER 

Y Z COORDINATE OF OBSERVER 

5 NUMBER OF RECEPTION TIMES ASSOCIATED WITH 

THIS OBSERVER (ASSUME VALUE IS M) 

N+4 RECORD FORMAT IS *RS 

I 

. RECEPTION TIMES FOR CURRENT OBSERVER 

. INDEX 

M 

RECORD N+5 THROUGH RECORD N+M+4 CONTAIN GEOMETRY DATA 
FOR EACH RECEPTION TIME STORED IN THE SAME MANNER AS 
DESCRIBED ABOVE IN RECORDS 3 THROUGH N-t-2. 


THE PATTERN AS SEEN IN RECORDS 1 THROUGH N+2 AND RECORDS 
N+3 THROUGH N+M+4 CONTINUES FOR ALL OBSERVERS 

OBSERV(COORD) - MULTI-RECORD MEMBER WITH FORMAT » 4H3RS$, 

CONTAINING ONE RECORD FOR EACH OBSERVER WITH 
VALUES OF THE X* Y* Z COORDINATES 

GEO(BOOY) - GEOMETRY ASSOCIATED WITH BODY AXES - SAME 
FORMAT AS FOR GEO(XXXX) 

GEO(WINO) - GEOMETRY ASSOCIATED WITH WIND AXES - SAME 
FORMAT AS FOR GEO(XXXX) 




Geometry Module (GEO) 
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SCRATCH(FLITAB)-TYP£ ONE DATA TABLE OF NINE FUNCTIONS OF 

FLIGHT TIME ARRANGED IN THE FOLLOWING ORDER 

1. FLIGHT TIME 

2. A/C X (EARTH FIXED) 

3. A/C Y (EARTH FIXED) 

4. A/C Z (EARTH FIXED) 

5. PSI EULER ANGLE (EARTH FIXED - BODY) 

6. TH EULER ANGLE (EARTH FIXED - BODY 

7. PHI EULER ANGLE (EARTH FIXED - BODY' 

8. PSI EULER ANGLE (BODY - WIND) 

9. TH EULER ANGLE (BODY • WIND) 

10. PHI EULER ANGLE (BODY - WIND) 


SCRATCH( FLIGHT) -TEMPORARY DATA UNIT(DATA MEMBER) TO HOLD 

OUTPUT DATA PRIOR TO TRANSLATION INTO OUTPUT 
COORDINATE SYSTEMS. THE MEMBER CONSISTS OF 
RECORDS IN IIRS FORMAT IN THE FOLLOWING ORDER 
1* RECEIVED TIME 
2* FLIGHT TIME 

3. A/C X (EARTH FIXED) 

4. A/C Y (EARTH FIXED) 

5. A/C Z (EARTH FIXED) 

6. PSI EULER ANGLE (EARTH FIXED - BODY) 

7. TH EULER ANGLE (EARTH FIXED - BODY) 

8. PHI EULER ANGLE (EARTH FIXED - BODY) 

9. PSI EULER ANGLE (BODY - WIND) 

10. TH EULER ANGLE (BODY - WIND) 

11. PHI EULER ANGLE (BODY - WIND) 


ERRORS 

NON-FATAL 

1. INSUFFICIENT LDS FOR EXECUTION 

2. MORE THAN 18 SOURCE COORDINATE SYSTEMS DEFINED 

3. UNABLE TO INTERPOLATE TABLE ATM(TMOD) 

4. - USER PARAMETER VALUE OUT OF RANGE, DEFAULT TO BE USED 

5. NO FLIGHT TIMES THAT CORRESPOND TO USER SUPPLIED 
INPUT PARAMETERS START AND STOP 

LDS REQUIREMENTS 

LENGTH » 8*( NSOURCE+2 ) + 3*NUM0BS + MAXTIMES + 10*NTIMES 
WHERE 

NSOURCE = NUMBER OF COORDINATE SYSTEMS 

NUMOBS » number OF OBSERVERS 

MAXTIMES = MAXIMUM NUMBER OF TIMES FOR ANY OBSERVER 

NTIMES = NUMBER OF FLIGHT PATH TIMES 

GDS REQUIREMENTS 

ALLOCATION REQUIRED FOR TABLES ATM(TMOD) AND SCRATCH(FLITAB) 


anONALPAttB 
OF POOR QUAUTV 

4.2»3 night Dynamics Module (PLI) 


PURPOSE - COMPUTES THE TWO-DIMENSIONAL TRAJECTORY OF AN AIRCRAFT 
AS A FUNCTION.OF TIME. 

AUTHOR - SLP(L03/00/00) 

CBF(L03/00/05 
DSW(L03/00/07 
SLP(L03/00/07 
MMF(L03/00/09) 

INPUT 

USER PARAMETERS 


lUNJTS SYSTEM OF UNITS 
2HSI SI 


DEFAULT 
SI UNITS 

2HSI 




NJO 

7HENQLISH ENGLISH 

NO. OF INTEGRATION STEPS COMPLETED 

0 

leaiNT 

INTEGER PRINT OPTION 

3 

IPTAPE 

0 NO PRINT DESIRED 

1 INPUT PRINT ONLY 

2 OUTPUT PRINT ONLY 

3 INPUT AND OUTPUT PRINT 

INTEGER TAPE OUTPUT OPTION 



0 NO PLOT FILE GENERATED 

1 tt.va*xa.zajhm.angle-of 

ATTACK AND POWER SETTING 
WRITTEN TO TAPE7 AT EACH 
TIME STEP. FORMAT! 7F15. 4) 

HEADER RECORD FORMAT(2Al5,2Fl5.4.A155 

I OUT 

OUTPUT MEMBER OPTION 

0 

J 

0 NO OUTPUT MEMBER 

1 OUTPUT IN ORIGINAL UNITS 
INITIAL INTEGRATION STEP NUMBER 

1 

TSTEP 

MAXIMUM ACCEPTABLE TIME INTERVAL 

1.0 

MSTEP 

BETWEEN INTEGRATION STEPS* 

SEC 

MAXIMUM MACH NUMBER INCREMENT 

0.1 

XI 

BETWEEN ENGINE TABLE ENTRIES 
DAMPING COEFFICIENT FOR PITCH DYNAMICS 

.95 

PITCH 

PITCH ANGLE, DEG 

0.0 

TL6 

LANDING GEAR RETRACTION TIME, 

0. 

AE 

SEC 

** REFERENCE VALUES ** 

ENGINE INLET REFERENCE AREA, 

PI/4 

AW 

M**2 (FT**2) 

WING REFERENCE AREA, 

100. 

, : ■' ■ ‘k ” 

‘Q V O 

M**2 (FT**2) 
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B 

Flight Dvfianllts Module (FL!) 
WING SPAN. M (FT) 

20. 

Ml 

FULLY loaded REFERENCE MASS. 

10000. 

21 

KG (SLUGS) 

ALTITUDE AT BRAKE RELEASE. . 

0. 

TAU 

M (FT) 

COEFFICIENT OF ROLLINQ FRICTION 

OJU 

NENG 

NUMBER OF ENGINES IN EACH GROUP 

l.O.O.O 

E 

ENGINE INCLINATION ANGLE WRT 0. 

.0. .0..0 

ENGNUM 

BODY AXES FOR EACH ENGINE GROUP* DEG 
ENGINE IDENTIFIER ARRAY FOR 

3HEN1... 


ENGINE GROUP 

3HEN4 

TT 

♦* CONDITIONS AT START OF FLIGHT SEGMENT ♦* 
INITIAL TIME. 

0.0 

VA 

SEC 

initial VELOCITY. 

0.0 

XA 

M/S (FT/S) 

INITIAL DISTANCE FROM ORIGIN. 

0.0 

YA 

M (FT) 

INITIAL SIDELINE DISTANCE. 

0.0 

ZA 

M (FT) 

INITIAL ALTITUDE 

OJJ—. 

MASS 

(ZA=21 IMPLIES AIRCRAFT IS ON. GROUND). 
M (FT) 

INITIAL MASS 

lOOOO. 

THW 

INITIAL FLIGHT PATH ANGLE. DEG 

0.0 

JF 

♦* STOPPING CRITERIA *♦ 

FINAL INTEGRATION STEP NUMBER LIMIT 

50 

TF 

FINAL TIME LIMIT. 

100. 

VF 

SEC 

FINAL VELOCITY LIMIT. 

155. 

XF 

M/S (FT/S) 

FINAL DISTANCE LIMIT. 

10000. 

ZF 

M (FT) 

FINAL ALTITUDE LIMIT. 

1000. 

M (FT) 

NORMAL TERMINATION OCCURS IF ANY OF THE ABOVE LIMITS 

IS 

REACHED OR IF THE LAST RECORD OF ANY OF THE PlLOT CONTROL 

MEMBERS 

IS SATISFIED. 



TABLES/MEMBERS 

NOTE: THE FOLLOWING ARE UNIT 
ATM(TMOD) 

AERO(CL) 

AERO CD) 

AERO(CDLG) 

ENG(DYN) 

FLI(TEMP) 

FLI(FLIXXX) 


( MEMBER ) NAMES 


♦NOT read if NJO-O* 

♦NOT OPENED IF lOUT-O^ 
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FH^nt Dynamics Module (FLI) 


FLI(PATH) *N0T OPENED IF IOUT-0* 

PILOT(CONTROL) 

PILOT(FLAP) 

PILOTjpOWERl) 

PILOT P0WER2 * READ ONLY IF NENQ HAS 2 OR MORE ELEMENTS 

PILOT jPOWERS) * READ ONLY IF NENG HAS 3 OR MORE ELEMENTS 

PIL0T(P0WER4) * READ ONLY IF NENG HAS 4 ELEMENTS 

OUTPUT 

USER PARAMETERS 

NJO NO. OF INTEGRATION STEPS COMPLETED 

TT actual FINAL TIME 

VA ACTUAL FINAL VELOCITY 

XA ACTUAL FINAL DISTANCE 

ZA ACTUAL FINAL ALTITUDE 

MASS FINAL MASS 

THH ACTUAL FINAL FLIGHT PATH ANGLE 

PITCH ACTUAL FINAL PITCH ANGLE 

HSTEP FINAL TIME STEP SIZE 


MEMBER DESCRIBED UNDER DATA BASE STRUCTURES 

FLI(PATH) - FLIGHT DATA AT EACH INTEGRATION STEP 
IN ORIGINAL UNITS. OUTPUT IF I0UT>0 
FLI(TEMP) - TEMPORARY INFORMATION USED BY THE 
INTEGRATOR TO RESTART. 

MEMBER IS WRITTEN ONCE FOR EACH CALL 
TO THE FLI MODULE. 

FLI(FLIXXX) FLIGHT DATA AT A FEW SELECTED TIMES. OUTPUT ONLY 
IF IOUT>0. 

ONE MEMBER CREATED FOR EACH ENGINE GROUP: XXX 
REPLACED BY ENGNUM(I), I » l.N. WHERE N = 

NUMBER OF ELEMENTS ASSOCIATED WITH PARAMETER, NENG 

SYSTEM PARAMETER 

NERR SYSTEM ERROR PARAMETER 

.TRUE* - ERROR ENCOUNTERED DURING MODULE 
EXECUTION 
.FALSE.- NO ERROR 


DATA BASE STRUCTURES 

ATM( TMOD ) - TYPE 1 DATA TABLE OF ATMOSPHERIC MODEL OF 

NINE FUNCTIONS OF ALTITUDE. 

VARIABLES IN THE FOLLOWING ORDER: 
(PRESSURE .DENSITY. TEMP. .SPEED OF SOUND, 
AVERAGE SPEED OF SOUND, 

ABSOLUTE HUMIOITY.COEFF. OF VISCOSITY. 
COEFF. OF THERMAL CONDUCTIVITY, 
CHARACTERISTIC IMPEDANCE) 
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AER0( CL ) - TYPE 1 DATA TABLE OF LIFT COEFF. AS A 

FUNCTION OF ANQLE-OF-ATTACK. FLAP SETTING 
AND NONOIMENSIONAL ALTITUDE. 

ANGLES IN DEGREES AND ALTITUDE DIVIDED 
BY WING SPAN. 


AERO( CD ) - TYPE 1 DATA TABLE OF DRAG COEFF. AS A 

FUNCTION OF ANGLE-OF-ATTACK* FLAP SETTING 
AND NONOIMENSIONAL ALTITUDE 
ANGLES IN DEGREES AND ALTITUDE DIVIDED 
BY WING SPAN 

AERO( CDLG ) - TYPE 1 DATA TABLE OF LANDING GEAR DRAG 
COEFF. AS A .FUNCTION OF LIFT COEFF. 

ENG(DYN) - TYPE 1 DATA TABLE OF ENGINE PERFORMANCE 
DATA; THREE FUNCTIONS OF MACH NUMBER AND 
POWER SETTING. DEPENDENT VARIABLES IN THE 
FOLLOWING ORDER: 

SPECIFIC THRUST, RE CA 
AIR FLOWRATE, RE RHOA*CA*AE 
FUEL FLOWRATE, RE RHOA*CA*AE 


PILOT(CONTROL)- INPUT UNIT MEMBER WITH FORMAT=2HCI. 

EACH "Cl" ( IE, CARO IMAGE ) RECORD HAS THE SAME 
FIELDS. THE FIELDS ARE AS FOLLOWS : 

FIELD CONTENTS 

1 ONE OF THE FOLLOWING CONDITION 
PARAMETER NAMES : 

MACH MACH NUMBER 

TIME TIME 

RANGE DOWNRANGE POSITION 

ATTACK ANGLE OF ATTACK 

ALTITUDE ALTITUDE 

PITCH PITCH ANGLE 

PATH FLIGHT PATH ANGLE 

2 ONE OF THE FOLLOWING LOGICAL 
OPERATORS : 

.EQ. .NE. .LE. .LT. .6E. .QT. 

3 CONDITION REFERENCE VALUE GIVEN BY 
EITHER A USER DEFINED PARAMETER NAME 
OR A “RS" VALUE 
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4 ONE OF THE FOLLOWING GOAL PARAMETER 

NAMES : 

MACH MACH NUMBER 

ATTACK ANGLE OF ATTACK 

PITCH PITCH ANGLE 

PITCHOT PITCH ANGLE RATE OF 

CHANGE 

PATH FLIGHT PATH 

PATHOT FLIGHT PATH RATE OF 

CHANGE 

B GOAL REFERENCE VALUE GIVEN BY EITHER 

A USER DEFINED PARAMETER NAME OR A 
“RS" VALUE 

6 FORCING FUNCTION CONSTANT GIVEN BY 

EITHER A USER DEFINED PARAMETER NAME 
OR A REAL SINGLE (RS) PRECISION VALUE 

THE VALUES SPECIFIED BY FIELDS 4, 5. AND 6 
IN RECORD 1 REMAIN IN EFFECT AS LONG AS THE 
CONDITION AS REFLECTED BY FIELDS 1. 2 AND 3 
REMAINS .TRUE. ONCE THIS CONDITION BECOMES 
.FALSE., FIELDS 1. 2 AND 3 OF THE NEXT RECORD 
ESTABLISH THE NEXT CONDITION TO BE TESTED. 

IF THIS CONDITION IS .TRUE., THEN FIELDS 4. 5 
AND 6 SPECIFY VALUES TO BE USED. WHEN THE 
CONDITION IS .FALSE., FIELDS 1, 2 AND 3 OF 
THE NEXT RECORD ESTABLISH THE NEXT CONDITION 
TO BE TESTED. THIS PATTERN CONTINUES UNTIL 
THE LAST RECORD IS PROCESSED. 


PILOT(FUP) 


INPUT UNIT member WITH FORMAT=2HCI. EACH RECORD 
HAS THE SAME FIELDS. THE FIELDS ARE AS FOLLOWS: 

field contents 

1 ONE OF THE FOLLOWING CONDITION 
PARAMETER NAMES : 

MACH MACH NUMBER 

TIME TIME 

RANGE DOWNRANGE POSITION 

ALTITUDE ALTITUDE 
FLAP FLAP ANGLE 

2 ONE OF THE FOLLOWING RELATIONAL 
OPERATORS : 

.EQ. .NE. .LT. .LE. .GT. .6E* 

3 CONDITION REFERENCE VALUE GIVEN BY 
EITHER A USER DEFINED PARAMETER NAME 
OR A "RS'' VALUE 
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4 ONE OF THE FOLLOWING GOAL PARAMETER 
NAMES : 

FLAP FLAP ANGLE 

FLAPDT FLAP ANGLE RATE OF 

CHANGE 

5 GOAL REFERENCE VALUE GIVEN BY EITHER 
A USER DEFINED PARAMETER NAME OR A 
“RS" VALUE 

THESE RECORDS ARE PROCESSED IN THE SAME 
MANNER AS DESCRIBED FOR UNIT MEMBER 
PILOT(CONTROL). 

PILOT(POWER) - INPUT UNIT MEMBER WITH F0RMAT-2HCI. EACH RECORD 
HAS THE SAME FIELDS. THE FIELDS ARE AS FOLLOWS: 

FIELD CONTENTS 

1 ONE OF THE FOLLOWING CONDITION 
PARAMETER NAMES : 

(4ACH MACH NUMBER 

TIME TIME 

RANGE DOWNRANGE POSITION 

ALTITUDE ALTITUDE 
POWER POWER SETTING 

2 ONE OF THE FOLLOWING RELATIONAL 

OPERATORS : 

.EQ. .NE. .LT. .LE. .6T. .6E. 

3 CONDITION REFERENCE VALUE GIVEN BY 
EITHER A USER DEFINED PARAMETER NAME 
OR AS A “RS" VALUE 

4 ONE OF THE FOLLOWING GOAL PARAMETER 
NAMES : 

POWER POWER SETTING 

POWEROT POWER SETTING RATE OF 

CHANGE 

5 GOAL REFERENCE VALUE GIVEN BY EITHER 
A USER DEFINED PARAMETER NAME OR A 
"RS" VALUE 

THESE RECORDS ARE PROCESSED IN THE SAME 
MANNER AS DESCRIBED FOR UNIT MEMBER 
P I LOT( CONTROL). 

FLI( PATH ) - OUTPUT MEMBER IN *RS FORMAT CONTAINING THE 

FOLLOWING TRAJECTORY DATA IN EACH OF THE 
NJO RECORDS: 

TIME.AIRCRAFT POSITION(X,Y,Z) .EULER ANGLES 
FROM VEHICLE CARRIED TO BODY AXIS. AND 
EULER ANGLES FROM BODY TO WIND AXIS. 
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EACH IS IN DIMENSIONAL UNITS. 

INPUT MEMBER OF THIS FORM IS OPTIONAL. 

USE ONLY IF FLIGHT PATH IS BUILT IN PIECES. 

FLI(FLIXXX) - OUTPUT MEMBER IN 6RS,A4,2RS FORMAT. EACH RECORD 
CONTAINS FLIGHT TIME .MACH NUMBER. POWER SETTING. 
AMBIENT SPEED OF SOUND.OENSITY.VISCOSITY, 

LANDING GEAR POSITION. FLAP SETTING AND ABSOLUTE 
HUMIDITY.(LANOING GEAR POSITION VALUES ARE 
EITHER 4HD0WN OR 4HUP .) 

ENGNUM(I) REPLACES XXX IN MEMBER NAME. 

ONE RECORD IS WRITTEN FOR EACH CHANGE IN POWER 
SETTING. FLAP SETTING. LANDING GEAR POSITION, 

AND FOR EACH TIME MACH NUMBER CHANGES BY 
PARAMETER. MSTEP. 

INPUT MEMBER IN THIS FORMAT IS OPTIONAL. USE 
ONLY IF FLIGHT- PATH IS BUiLT IN PIECES. 

FLI(TEMP) - OUTPUT MEMBER IN *RS FORMAT CONTAINING ONE . 

RECORD OF INTEGRATOR RESTART INFO. THIS MEMBER 
IS READ ONLY BY THEFLl MODULE ITSELF AND ONLY 
WHEN A FLIGHT PATH IS BUILT BY SUCCESSIVE CALLS 
TO FLI. 

ERRORS 

NON-FATAL 

1. INSUFFICIENT SPACE IN LDS 

2. INPUTS INVALID 

3. MEMBER MANAGER ERROR ON OPENING DATA UNITS 

4. ERROR IN INTEGRATION OR INTERPOLATION ROUTINE 

5. ILLEGAL TRAJECTORY DETECTED 
FATAL 

NONE 

LDS REQUIREMENTS 

LENGTH « NEQ * ( 22 + NEQ ) + ( FLPMAX * 5 ) + ( CTLMAX * 6 ) + 
( POWMAX(l) * 95 ) 

+ ( POWMAX(2) * 95 ) (* IF NENG HAS 2 OR MORE ELEMENTS *) 

+ ( POWMAX 3 * 95 ) {* IF NENG HAS 3 OR MORE ELEMENTS *) 

+ ( POWHAX{4) * 95 ) (* IF NEMG HAS 4 ELEMENTS *) 

WHERE 

NEQ - NUMBER OF EQUATIONS PASSED TO THE INTEGRATION 
ROUTINE 

FLPMAX » NUMBER OF RECORDS ON THE PILOT'S FLAP CONTROL 
MEMBER 

CTLMAX » number OF RECORDS ON THE PILOT'S CONTROL MEMBER 

POWMAX(l) » NUMBER OF RECORDS ON THE PILOT'S POWER SETTING 
ARRAY. FOR FIRST ENGINE GROUP 
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P0WMAX(2) = NUMBER OF RECORDS ON THE PILOT'S POWER SETTING 
ARRAY, FOR SECOND ENGINE GROUP 
P0WMAX(3) » NUMBER OF RECORDS ON THE PILOT'S POWER SETTING 
ARRAY, FOR THIRD ENGINE GROUP 

P0WMAX(4) » NUMBER OF RECORDS ON THE PILOT'S POWER SETTING 
ARRAY, FOR FOURTH ENGINE GROUP 


GDS REQUIREMENTS 

SUFFICIENT ALLOCATION FOR THE FOLLOWING TABLES : 
ATM(TMOD) 

AERO(CL) 

AERO(CD) 

AERO(COLQ) 

ENG(OYN) 
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4.3 PROPAGATION EFFECTS 
4.3.1 Atmospheric Atx&arptlon Module (ABS)- 


PURPOSE. COMPUTE AVERAGE ABSORPTION/WAVELENGTH AS FUNCTION 
OF ALTITUDE AND FREQUENCY AND BUILD TABLE 

AUTHOR SWP(L03/00/00) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS DEFAULT 

IN SI UNITS 

lUNITS INPUT UNITS CODE 2HSI 

=2HSI , INPUTS IN SI UNITS 
=7HENGLISH, inputs in ENGLISH UNITS 
ABSINT NUMBER OF INTEGRATION STEPS 5 

IPRINT INTEGER PRINT OPTION 3 

0 NO PRINT DESIRED 

1 INPUT PRINT ONLY 

2 OUTPUT PRINT ONLY 

3 INPUT AND OUTPUT PRINT DESIRED 

SAE METHOD OPTION (L) F 

.TRUE. - SAE ARP 866 METHOD 
.FALSE. - ANSI STANDARD METHOD 


MEMBERS DESCRIBED UNDER DATA BASE STRUCTURES 
SFIELD{ FREQ ) 

NOTE: MEMBERS ARE SPECIFIED BY UNIT( MEMBER ) NAME 
TABLES DESCRIBED UNDER DATA BASE STRUCTURES 

ATM( TMOO ) 

OUTPUT 

SYSTEM PARAMETER 

NERR EXECUTIVE SYSTEM ERROR INDICATOR (L) 

^RUE. • ERROR ENCOUNTERED DURING MODULE 
EXECUTION 

.FALSE. - NO ERROR ENCOUNTERED 
TABLES DESCRIBED UNDER DATA BASE STRUCTURES 

ATM( AAC ) 

DATA BASE STRUCTURES 

ATM( TMOD ) TWO-DIMENSIONAL TYPE ONE DATA TABLE OF 
ATMOSPHERIC MODEL OF NINE FUNCTIONS 
INDEPENDENT VARIABLES 

1. ALTITUDE 

2. ORDERED POSITION 
DEPENDENT VARIABLES 

WITH VALUES IN DIMENSIONLESS UNITS 
ARRANGED IN FOLLOWING ORDER - 

1. PRESSURE 

2. DENSITY 

3. TEMPERATURE 
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4. SPEED OF SOUND 

5. AVERAGE SPEED OF SOUND 

6. HUMIDITY 

7. COEFFICIENT OF VISCOSITY 

8. COEFFICIENT OF THERMAL CONDUCTIVITY 

9. CHARACTERISTIC IMPEDANCF 
LINEAR INTERPOLATION AND CLOSEST VALUE 
EXTRAPOLATION 

ATM( AAC ) TYPE ONE DATA TABLE OF ATMOSPHERIC ABSORPTION 
COEFFICIENT AS FUNCTION OF ALTITUDE AND 
FREQUENCIES. NO EXTRAPOLATION 
AND LINEAR INTERPOLATION • 

SFIELD(FREQ) 1 RECORD MEMBER IN *RS FORMAT CONTAINING VALUES 
OF-.1/3 OCTAVE BAND CENTER FREQUENCIES IN HERTZ 


ERRORS 

NON-FATAL 

1. UNABLE TO INTERPOLATE TABLE ATM(TMOD) 

2. UNABLE TO BUILD TABLE ATM(AAC) 

3. INSUFFICIENT SPACE IN LDS FOR REQUIRED ALLOCATION 
FATAL - NONE 
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4-»3-«2 Ground Reflection and Attenuation Module (GRA) 


PURPOSE - COMPUTE GROUND EFFECTS FACTOR AND BUILD TABLE 

AUTHOR - SWP(L03/00/00) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS DEFAULT 

COH INCOHERENCE COEFFICIENT .01 

C AMBIENT SPEED OF SOUND AT THE GROUND 340.294 

M/S. (FT/S) 

RHO AMBIENT AIR DENSITY AT GROUND, 1.225 

KG/M**3 (SLUG/FT**3) 

SIGMA GROUND FLOW RESISTANCE, 2.5*10**5 

KG/(S M**3) OR (SLUG/(S FT**3)) 

GRARF TWO WORD ARRAY CONTAINING FIRST AND 50. 

LAST VALUE OF FREQUENCY. HZ 2000. 

GRARD TWO WORD ARRAY CONTAINING FIRST AND 100. 

LAST VALUE OF DISTANCE ,M( FT) 1000. 

GRART TWO WORD ARRAY CONTAINING FIRST AND 0. 

LAST VALUES OF THETA, DEG 90. 

GRAIO INDEX FOR GROUND EFFECT OPTION 1 

ID = 0 IMPLIES HARD SURFACE SUCH AS CEMENT 
ID * 1 IMPLIES TYPICAL SOFT GROUND 
GRAND NUMBER OF GROUND DIPS TO BE INCLUDED 5 

GRANP NUMBER OF POINTS IN EACH GROUND DIP 5 

GRANT NUMBER OF INCIDENCE ANGLES 10 

GRANF NUMBER OF FREQUENCIES 5 

GRANR2 NUMBER OF IMAGE DISTANCES 5 


NSUBB NUMBER OF SUBBANOS PER 1/3 OCTAVE BAND 1 

IPRINT PRINT OPTION 3 

0 NO PRINT 

1 INPUT PARAMETER PRINT ONLY 

2 OUTPUT PRINT ONLY 

3 BOTH INPUT PARAMETER AND OUTPUT PRINT 

DATA BASE MEMBERS 
NONE 
OUTPUT 

SYSTEM PARAMETER 

NERR SET TO .TRUE. IF ERROR ENCOUNTERED 

DATA BASE MEMBERS 

TAB(GE) TYPE 1 DATA TABLE OF GROUND EFECT FACTOR AS 

FUNCTION OF PATH DIFFERENCE. COSINE OF INCIDENCE 
ANGLE BAND WIDTH FACTOR, AND IMAGE DISTANCE 
NOTE: FOR CASE WHERE GRAIO » 0 

GRANT. GRANF AND GRANR2 ARE SET « 1 
COSINE OF INCIDENCE ANGLE IS SET = 1 
BAND WPTH FACTOR IS SET = 0 
IMAGE Di STANCE IS SET = 1 


SO THAT GROUND EFFECT FACTOR IS IN EFFECT A 
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Gr ound Reflect i on and Attenuation Module (GRA) 


FUNCTION OF PATH DIFFFKENCE ONLY, ALTHOUGH TABLE 
IS FOUR-DIMENSIONAL 

ERRORS 

1. INSUFFICIENT SPACE IN LDS 

2. ERROR IN ATTEMPT TO BUILD TABLE 

3. USER PARAMETERS INVALID 
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4.4 SOURCE NOISE PARAMETERS 
4.4.1 Fan Noise Parameters Module (PREFAN) 


PURPOSE - TO GENERATE THE PHYSICAL PARAMETERS REQUIRED BY 
HEIDMAN’S METHOD FOR FAN NOISE PREDICTION FOR 
TURBOJET AND TURBOFAN ENGINES 

AUTHOR - CBF(L03/00/00) 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS 
IPRINT - PRINTED OUTPUT OPTION 

0 - NO PRINT DESIRED 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 
lUNITS - INPUT UNIT OPTION 

2HSI, SI UNITS 
7HENGLISH, ENGLISH UNITS 

ITYPE - TYPE OF INTERPOLATION TO BE USED ON THE 
INPUT TABLES 

1 - LINEAR INTERPOLATION 

2 - CUBIC SPLINE INTERPOLATION 
SCRXXX - THREE LETTER CODTE XXX USED TO FORM THE 

UNIT MEMBER NAME FLI(FLIXXX). IF THE 
VALUE OF USER PARAMETER SCRXXX 
IS 3HABC, THE FLI UNIT MEMBER NAME IS 
FLI(FLIABC). 

MEMBERS AND TABLES - DESCRIBED UNDER DATA BASE STRUCTURES 
FLI(FLIXXX) - (SEE USER PARAMETER SCRXXX) 

ENG(FANl) 

ENG(FAN2) 

OUTPUT 

SYSTEM PARAMETER 

NERR - EXECUTIVE SYSTEM PARAMETER FOR ERROR ENCOUNTERED 
DURING EXECUTION OF A FUNCTIONAL MODULE 
s.TRUE., ERROR ENCOUNTERED 
«. FALSE., NO ERRORS 

USER PARAMETERS 

NTIMES - NUMBER OF SOURCE TIME VALUES 
TIMES - MULTI-ELEMENT PARAMETER CONTAINING THE SOURCE 
TIMES 

MTl - MULTI-ELEMENT PARAMETER CONTAINING THE FAN 
ENTRANCE MASS FLOW RATE AT EACH SOURCE TIME 
MT2 - MULTI-ELEMENT PARAMETER CONTAINING THE FAN 
EXIT MASS FLOW RATE FOR EACH SOURCE TIME 
MTA - MULTI-ELEMENT PARAMETER CONTAINING THE AIRCRAFT 
MACH NUMBER FOR EACH TIME 


DEFAULT 

3 

2HSI 

1 

3HXXX 
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NTl - MULTI-ELEMENT PARAMETER CONTAINING THE 
ROTATIONAL SPEED FOR EACH TIME 
DTI - MULTI-ELEMENT PARAMETER CONIATNING THE 

TOTAL TEMPERATURE RISE ACROSS FAN FOR EACH TIME 
CTA - MULTI-ELEMENT PARAMETER CONTAINING THE AMBIENT 
SPEED OF SOUND FOR EACH TIME 
RHOTA - MULTI-ELEMENT PARAMETER CONTAINING THE AMBIENT 
DENSITY FOR EACH TIME 

HATA RAV 

FLI(FLIXXX) MULTI-ELEMENT MEMBER WITH FORMAT*6RS,A4,2RS, 
WITH ONE RECORD PER SOURCE TIME CONTAINING 
THE FOLLOWING VALUES : (1) SOURCE TIME, (2) 
AIRCRAFT MACH NUMBER, (3) ENGINE POWER 
SETTING, (4) AMBIENT SPEED OF SOUND, (5) 
AMBIENT DENSITY, (6) AMBIENT DYNAMIC 
VISCOSITY, (7) LANDING GEAR POSITION, (8) 

FLAP SETTING AND (9) ABSOLUTE HUMIDITY. 

ONLY THE FIRST FIVE ENTRIES ARE USED. 
ENG(FANl) THREE-DIMENSIONAL TYPE ONE DATA TABLE 

CONTAINING THE FAN ENTRANCE FLOW STATE AS 
A FUNCTION OF (1) ENGINE POWER SETTING, 

(2) AIRCRAFT MACH NUMBER AND (3) ORDERED 
POSITION. THE FLOW STATE DEPENDENT VARIABLES 
IN ORDERED POSITION ARE : AREA, 

FUEL-TO-AIR RATIO, MASS FLOW RATE, TOTAL 
PRESSURE, TOTAL TEMPERATURE, AND ROTATIONAL 
SPEED. 

(ONLY MASS FLOW RATE, ROTATIONAL SPEED, AND 
TOTAL TEMPERATURE ARE REQUIRED) 

ENG(FAN2) THREE-DIMENSIONAL TYPE ONE DATA TABLE 

CONTAINING THE FAN EXIT FLOW STATE AS A 
FUNCTION OF (1) ENGINE POWER SETTING, 

(2) AIRCRAFT MACH NUMBER AND (3) ORDERED 
POSITION. THE FLOW STATE DEPENDENT 
VARIABLES IN ORDERED POSITION ARE : AREA, 
FUEL-TO-AIR RATIO, MASS FLOW RATE, TOTAL 
PRESSURE, TOTAL TEMPERATURE AND 
ROTATIONAL SPEED. 

(ONLY MASS FLOW RATE AND TOTAL TEMPERATURE 
ARE REQUIRED) 

ERRORS 

NON-FATAL 

1. MEMBER MANAGER ERROR OCCURRED ON SPECIFIED UNIT MEMBER. 

2. INSUFFICIENT LOCAL DYNAMIC STORAGE. 

3. REQUIRED UNIT MEMBER NOT AVAILABLE. 

4. UNABLE TO INTERPOLATE SPECIFIED TABLE. 

FATAL - NONE 
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PURPOSE - rO GENERATE THE PHYSICAL PARAMETERS REQUIRED FOR A 
CORE NOISE PREDICTION MODULE 

AUTHOR - CBF(L03/00/00) 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS 

I PR I NT - PRINTED OUTPUT OPTION 

0 - NO PRINT DESIRED 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 
lUNITS - INPUT UNIT OPTION 

2HSI, SI UNITS 
7HENGLISH, ENGLISH UNITS 
ITYPE - TYPE OF INTERPOLATION TO BE USED ON THE 
INPUT TABLES 

1 - LINEAR INTERPOLATION 

2 - CUBIC SPLINE INTERPOLATION 
SCRXXX - THREE LETTER CODE XXX USED TO FORM THE 

UNIT MEMBER NAME FLI(FLIXXX). IF THE 
VALUE OF USER PARAMETER SCRXXX 
IS 3HABC, THE FLI UNIT MEMBER NAME IS 
FLI(FLIABC). 

MEMBERS AND TABLES - DESCRIBED UNDER DATA BASE STRUCTURES 
FLI(FLIXXX) - (SEE USER PARAMETER SCRXXX) 

ENG( CORED 
ENG(C0RE2) 

OUTPUT 

SYSTEM PARAMETER 

NERR - EXECUTIVE SYSTEM PARAMETER FOR ERROR ENCOUNTERED 
DURING EXECUTION OF A FUNCTIONAL MODULE 

USER PARAMETERS 

NTIMES - NUMBER OF SOURCE TIME VALUES 
TIMES - MULTI-ELEMENT PARAMETER CONTAINING THE SOURCE 
TIMES 

MTl - MULTI-ELEMENT PARAMETER CONTAINING THE COMBUSTOR 
ENTRANCE MASS FLOW RATE VALUES FOR EACH TIME 
MTA - MULTI-ELEMENT PARAMETER CONTAINING THE AIRCRAFT 
MACH NUMBER FOR EACH TIME 

PTl - MULTI-ELEMENT PARAMETER CONTAINING THE COMBUSTOR 
ENTRANCE TOTAL PRESSURE FOR EACH TIME 
TTl - MULTI-ELEMENT PARAMETER CONTAINING THE COMBUSTOR 
ENTRANCE TOTAL TEMPERATURE FOR EACH TIME 


DEFAULT 

3 

2HSI 

1 

3HXXX 
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TT2 - MULTI-ELEMENT PARAMETER CONTAINING THE COMBUSTOR 
EXIT TOTAL TEMPERATURE FOR EACH TIME 

CTA - MULTl-ELEMEMT PARAMETER CONTAINING THE AMBIENT 
SPEED OF SOUND FOR EACH TIME 

RHOTA - MULTI-ELEMENT PARAMETER CONTAINING THE AMBIENT 
DENSITY FOR EACH TIME 

DATA kA^P ^TRIirTIIBP^ 

FLI(FLIXXX) ItJLTI-ELEMENT MEMBER WITH FORMAT = 6RS.A4.2RS. 

WITH ONE RECORD PER SOURCE TIME CONTAINING THE 
FOLLOWING VALUES: (1) SOURCE TIME. (2) AIRCRAFT 
MACH NUMBER. (3) ENGINE POWER SETTING. (4) 

AMBIENT SPEED OF SOUND. (5) AMBIENT DENSITY. (6) 
AMBIENT DYNAMIC VISCOSITY. (7) LANDING GEAR 
POSITION. (8) FLAP SETTING AND (9) ABSOLUTE 
HUMIDITY. ONLY THE FIRST FIVE VALUES ARE USED. 

ENG(COREl) THREE-DIMENSIONAL TYPE ONE DATA TABLE CONTAINING 
THE CORE ENTRANCE FLOW STATE AS A FUNCTION OF 
(1) ENGINE POWER SETTING. (2) AIRCRAFT MACH 
NUMBER AND (3) ORDERED POSITION. THE FLOW STATE 
DEPENDENT VARIABLES IN ORDERED POSITION ARE : 
AREA. FUEL-TO-AIR RATIO. MASS FLOW RATE. TOTAL 
PRESSURE. TOTAL TEMPERATURE, AND ROTATIONAL 
SPEED. 

(ONLY MASS FLOW RATE. TOTAL PRESSURE. AND TOTAL 
TEMPERATURE ARE REQUIRED) 

ENG(C0RE2) THREE-DIMENSIONAL TYPE ONE DATA TABLE CONTAINING 
THE CORE EXIT FLOW STATE AS A FUNCTION OF 
(1) ENGINE POWER SETTING. (2) AIRCRAFT MACH 
NUMBER AND (1) ORDERED POSITION. THE FLOW STATE 
DEPENDENT VARIABLES IN ORDERED POSITION ARE : 
AREA. FUEL-TO-AIR RATIO. MASS FLOW RATE. TOTAL 
PRESSURE. TOTAL TEMPERATURE AND ROTATIONAL SPEED. 
(ONLY TOTAL TEMPERATURE IS REQUIRED) 

ERRORS 

NON-FATAL 

1. MEMBER MANAGER ERROR OCCURRED ON SPECIFIED UNIT MEMBER. 

2. INSUFFICIENT LOCAL DYNAMIC STORAGE. 

3. REQUIRED UNIT MEMBER NOT AVAILABLE. 

4. UNABLE TO INTERPOLATE SPECIFIED TABLE. 

FATAL - NONE 

LDS REQUIREMENTS 

( 13 * NTIMES ) + 1 
WHERE 

NTIMES - NUMBER OF SOURCE TIMES 
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4,4.3 Turbine Noise Parameters Wo<lule (PRETUR) 


PURPOSE - TO GENERATE THE PHYSICAL PARAMETERS REQUIRED FOR A 
TURBINE NOISE PREDICTION MODULE FOR TURBOJET AND 
TURBOFAN ENGINES 

AUTHOR - CBF(L03/00/00) 

MMF(L03/00/09) 


input DEFAULT 

USER PARAMETERS 

IPRINT - PRINTED OUTPUT OPTION 3 

0 - NO PRINT DESIRED 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - POTH INPUT AND OUTPUT PRINT 

lUNITS - INPUT UNIT OPTION 2HSI 

2HSI, SI UNITS 
7HENGLISH, ENGLISH UNITS 

ITYPE - TYPE OF INTERPOLATION TO BE USED ON THE 1 

INPUT TABLES 

1 - LINEAR INTERPOLATION 

2 - CUBIC SPLINE INTERPOLATION 

IRATIO - SPECIFIC HEATS OPTION 8HC0NSTANT 

8HC0NSTANT - CONSTANT SPECIFIC HEATS 
8HVARIA8LE - VARIABLE SPECIFIC HEATS 
SCRXXX - THREE LETTER CODE XXX USED TO FORM THE 3HXXX 
UNIT MEMBER NAME FLI(FLIXXX). IF THE 
VALUE OF USER PA".AMETER SCRXXX 
IS 3HABC, THE FLI UNIT MEMBER NAME IS 
FLI(FLIABC). 

MEMBERS AND TABLES - DESCRIBED UNDER DATA BASE STRUCTURES 
FLI(FLIXXX) - (SEE USER PARAMETER SCRXXX) 

ENG(TURBINEl) 

ENG(TURBINE2) 


OUTPUT 

SYSTEM PARAMETER ^ 

NERR - EXECUTIVE SYSTEM PARAMETER FOR ERROR ENCOUNTERED 
DURING EXECUTION OF A FUNCTIONAL MODULE 
».TRUE., AN ERROR WAS ENCOUNTERED 
s. FALSE., NO ERRORS 


USER PARAMETERS 

NTIMES - NUMBER OF SOURCE TIME VALUES 
TIMES - MULTI-ELEMENT PARAMETER CONTAINING THE SOURCE 
TIMES 

MTA - MULTI-ELEMENT PARAMETER CONTAINING THE AIRCRAFT 
MACH NUMBER FOR EACH TIME 


4-27 


ORIGIilAL PACS f’** 
OF POOR QUAUrfY 


Turbine Noise Parameters Module (PRETUR) 


NTl - MULTI-ELEMENT PARAMETER CONTAINING THE 
ROTATIONAL SPEED FOR EACH TIME 
TTl - MULTI-ELEMENT PARAMETER CONTAINING THE TURBINE 
ENTRANCE TOTAL TEMPERATURE FOR EACH TIME 
TT2 - MULTI-ELEMENT PARAMETER CONTAINING THE TURBINE 
EXIT STATIC TEMPERATURE FOR EACH TIME 
MTl - MULTI-ELEMENT PARAMETER CONTAINING THE TURBINE 
MASS FLOW RATE FOR EACH TIME 
FTA - MULTI-ELEMENT PARAMETER CONI AIMING THE 
FUEL-TO-AIR RATIO FOR EACH TIME 
CTA - MULTI-ELEMENT PARAMETER CONTAINING THE AMBIENT 
SPEED OF SOUND FOR EACH TIME 
RHOTA - MULTI-ELEMENT PARAMETER CONTAINING THE AMBIENT 
DENSITY FOR EACH TIME 

HTA - MULTI-ELEMENT PARAMETER CONTAINING THE ABSOLUTE 
HUMIDITY FOR EACH TIME 

nATA RA^P ^TPlirTlIRP^ 

FLI(FLIXXX) MULTI-ELEMENT MEMBER WITH F0RMAT»6RS,A4.2RS. 

WITH ONE RECORD PER SOURCE TIME CONTAINING 
THE FOLLOWING VALUES ; (1) SOURCE TIME. (2) 
AIRCRAFT MACH NUMBER, (3) ENGINE POWER 
SETTING. (4) AMBIENT SPEED OF SOUND, (5) 
AMBIENT DENSITY, (6) AMBIENT DYNAMIC 
VISCOSITY, (7) LANDING GEAR POSITION, (8) 

FLAP SETTING AND (9) ABSOLUTE HUMIOr.Y. 

ONLY THE VALUES OF THE FOLLOWING ENTRIES ARE 
USED: 1. 2, 3, 4, 5, AND 9 

ENG(TURBINEl) THREE-DIMENSIONAL TYPE ONE DATA TABLE 

CONTAINING THE TURBINE ENTRANCE FLOW STATE AS 
A FUNCTION OF (1) ENGINE POWER SETTING, 

(2) AIRCRAFT MACH NUMBER AND (3) ORDERED 
POSITION. THE FLOW STATE DEPENDENT VARIABLES 
IN ORDERED POSITION ARE : AREA, 

FUEL-TO-AIR RATIO. MASS FLOW RATE, TOTAL 
PRESSURE, TOTAL TEMPERATURE* AND ROTATIONAL 
SPEED. 

(ONLY MASS FLOW RATE, ROTATIONAL SPEED, AND 
TOTAL TEMPERATURE ARE REQUIRED) 

ENG(TURBINE2) THREE-DIMENSIONAL TYPE ONE DATA TABLE 

CONTAINING THE TURBINE EXIT FLOW STATE AS A 
FUNCTION OF (1) ENGINE POWER SETTING, 

(2) AIRCRAFT MACH NUMBER AND (1) ORDERED 
POSITION. THE FLOW STATE DEPENDENT 
VARIABLES IN ORDERED POSITION ARE : AREA, 
FUEL-TO-AIR RATIO, MASS FLOW RATE, TOTAL 
PRESSURE, TOTAL TEMPERATURE, AND 
ROTATIONAL SPEED. 

(ALL BUT ROTATIONAL SPEED ARE REQUIRED) 
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ERRORS 

NON-FATAL 

1. MEMBER MANAGER ERROR OCCURRED ON SPECIFIED UNIT MEMBER. 

2. INSUFFICIENT LOCAL DYNAMIC STORAGE. 

3. REQUIRED UNIT MEMBER NOT AVAILABLE. 

4. UNABLE TO INTERPOLATE SPECIFIED TABLE. 

FATAL - NONE 

LDS REQUIREMENTS 

LENGTH » ( NTIMES * ( NWOROS + ( NP - 1 ) ) + 1 ) 

WHERE 

NTIMES = NUMBER OF SOURCE TIMES 
NWORDS « NUMBER OF WORDS READ PER RECORD ON MEMBER 
CONTAINING ENGINE VARIABLE DATA 
NP « NUMBER OF USER PARAMETERS OUTPUT FROM THIS 
MODULE 

GDS REQUIREMENTS 

ALLOCATION REQUIRED FOR THE FOLLOWING TABLES 

1. ENG(TURBINEl) 

2. ENG(TURBINE2) 
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4»4,4 Jet Noise Parameters Module (PREJET) 


PURPOSE - GENERATE THE PHYSICAL PARAMETERS REQUIRED FOR THE 

EXHAUST JET NOISE PREDICTION MODULES FOR TURBOJET AND 
TURBOFAN ENGINES 

AUTHOR - CBF(L03/00/00) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS 

AE - ENGINE REFERENCE AREA, M**2 (FT**2) 

AP - PRIMARY NOZZLE PLUG AREA, RE AE 
SCRXXX - THREE LETTER CODE XXX USED TO FORM THE 
UNIT MEMBER NAME FLI(FLIXXX). IF THE 
VALUE OF THE SCRXXX USER PARAMETER 
IS 3HABC, THE FLI UNIT MEMBER NAME IS 
FLI(FLIABC). 

IRATIO - SPECIFIC HEATS OPTION 

8HC0NSTANT - CONSTANT RATIO OF SPECIFIC 
HEATS 

8HVARIABLE - VARIABLE RATIO OF SPECIFIC 
HEATS 

ITYPE - TYPE OF INTERPOLATION TO BE USED ON THE 
INPUT TABLE (S) 

1 - LINEAR INTERPOLATION 

2 - CUBIC SPLINE INTERPOLATION 
lUNITS - INPUT UNIT OPTION 

2HSI, SI UNITS 
7HEN6LISH, ENGLISH UNITS 
I PR I NT - PRINTED OUTPUT OPTION 

0 - NO PRINT DESIRED 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 


DEFAULT 

PI/4. 

0 . 

3HXXX 


8HC0NSTANT 


1 


2HSI 


3 


MEMBERS AND TABLES - DESCRIBED UNDER DATA BASE STRUCTURES 
FLI(FLIXXX) 

ENG(PRIM) 

ENG(SEC) 


OUTPUT 

SYSTEM PARAMETER 

NERR EXECUTIVE SYSTEM PARAMETER FOR ERROR ENCOUNTERED 
DURING EXECUTION OF A FUNCTIONAL MODULE. 

IKFU PAUAMFTPU*\ 

NT I ME S - NUMBER OF SOURCE TIME VALUES 
TIMES - MULTI-ELEMENT PARAMETER CONTAINING THE SOURCE 
TIMES 
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Jot Noise l‘drainoters Mtuliilo 


AH » Mlll.n-H.I M 1 Nr l»AKAMl.Tl.K CONrAlNlNU IHI PKIMARY Jl r 
ARI A l OR lACM HMI 

MIA - Mtll.n-HlMi Nr 1‘ARAMi ri R CONrAININO rill AIRCRAII 
MACH NtIMIIIR H)R I ACM IIMI. 

Hill - Mlll.n-I.UMI N1 PARAMI.UR CONIAINING IHI ACrUAL 
PRIMARY Jl l I QIIIVAI I NI MIAMI H R lOR I ACM riMI 

nun - MiiLn-uiMiNi paramuir coniaininu nil aciiiai 

PRIMARY Ji r HYMRAUI IC HIAMI IIR M)R I ACM HMI. 

Mi l - Mill n-t LI MI NI PARAMUI R CONrAlNlNG IHI. PRIMARY Jl l 
MACH NHMHl R KIR I. ACM 1 1 Ml 

rn - MiiLn-i.u.Mi;Nr PARAMiriR coNrAiNiNu riii primary jir 
rorAI. ILMPI RATlIRl lOR I ACH HMI 
vn - MiiLn-LUMiNr paramlyir coniaining rill primary Jir 

VI LOCI rY lOR I ACH HMI. 

RSliri - MllLri-LLl.MLNr PARAMLlhR CONTAINING THt RATIO 01 
SPLCinC HI ATS FOR THL PRIMARY Jll FOR I ACH TlMl 
RHOri - MIILII-LLLMINT PARAMUIR CONTAINING IHL PRIMARY JIT 
lUNSlTY FOR LACH TlML 

CTA - Mill Tl-LLLMLNT PARAMULR CONTAINING IHL AMHII.NT 
spu n OF SlUINO I OR LACH 11 ML 
RHOTA - MIILII-LLLMLNI PARAMULR CONTAINING THl AMHILNI 
lUNSllY FOR LACH 1 IML 

( THl FOLLOWING IISI R PARAMUI.RS ARl COMPIIUO ONLY lOR A 
nOURLL STRI AM TlIRHOl AN INGlNI. ) 

AU - MULll-LLI.Ml.NT PARAMULR CONTAINING illl SLCONOARY 
JI T ARi A I OR I ACH TlML 

MT.’ - MULTI-LLIMI NT PARAMULR CONTAINING THL SLCONOARY 
JLT MACH NIJMBLR FOR LACH TlML 
IT^ - MllUl-LLIMLNT PARAMLTIK CONI AIMING IHL SLCONOARY 
JLT TOTAL TI MPIRATURL FOR LACH HMI 
VT,» - MULTI-LLLMLNT PARAMl TI.R CONTAINING THL SLCONOARY 
JLT VFLOCITY FOR I ACH TlMl 

RHOT.> - MllUl-LLIMl NT PARAMUIR CONTAINING THl. SLCONOARY 
JLT OLNSITY FOR LACH TlML 

RSHl;* - WIUl-LLIMLNl PARAMUIR CONlAlNlNG THl RATIO OF 

SPLCIFlC HI.ATS lOR THL SI CONOARY Jll FOR LACH TlMl 
Oll;» - MllUl-ILLMINT PARAMULR CONTAINING THL ACIUAL 
SLCONOARY JLT LQUIVALINT OIAMUIR FOR LACH TlMl 
OHTP - MlIU I -1.1.1 MINI PARAMULR CONTAINING THL ACTUAL 
SI CONOARY JI T HYORAULIC OlAMUlR LOR LACH TIML 

DATA BASL SIRUCTURI S 

lU(FLIXXX) MULTl-LLIMI.NT Ml MOI R WITH lORMAI GRS,A4,;>RS, 
WITH ONI RICORO PI R SOlIRCI. IIMI. CONlAlNlNG THL 
lOLI OWING VALUI S: (!) SOURCI TlML . (P) 

AlRC.RAIl MACH NllMOl R» (.1) LNGlNI POWLR 
SIITING, (4) AMIUINl SPI 1 0 OF SOUNO, (S) 

AMRlINl OINSllY, (b) AMOU NT OYNAMlC 
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Jet Noise Parameters Module (PREJET) 


VISCOSITY, (7) LANDING GEAR POSITION. (8) 

FLAP SET.TING, AND (9) ABSOLUTE HUMIDITY. 

ONLY THE FOLLOWING VALUES ARE USED : (1) 

TIME. (2) AIRCRAFT MACH NUMBER. (3) ENGINE 
POWER SETTING. (4) AMBIENT SPEED OF SOUND, (5) 
AMBIENT DENSITY, AND (9) ABSOLUTE HUMIDITY. 

ENG(PRIM) THREE-DIMENSIONAL TYPE ONE DATA TABLE CONTAINING 
THE PRIMARY NOZZLE FLOW STATE AS A FUNCTION OF 
(l)ENGINE POWER SETTING, (2)AIRCRAFT MACH NUMBER, 
AND (3) ORDERED POSITION. THE FLOW STATE 
DEPENDENT VARIABLES IN ORDERED POSITION ARE ; 
AREA, FUEL-TO-AIR RATIO, MASS FLOW RATE, TOTAL 
PRESSURE, TOTAL TEMPERATURE, AND ROTATIONAL 
SPEED. (ROTATIONAL SPEED IS NOT REQUIRED) 

ENG(SEC) THREE-DIMENSIONAL TYPE ONE DATA TABLE CONTAINING 
THE SECONDARY NOZZLE FLOW STATE AS A FUNCTION OF 
(l)ENGINE POWER SETTING. (2)AIRCRAFT MACH NUMBER. 
AND (3)ORDERED POSITION. THE FLOW STATE DEPENDENT 
VARIABLES IN ORDERED POSITION ARE : AREA. 
FUEL-TO-AIR RATIO. MASS FLOW RATE, TOTAL 
PRESSURE, TOTAL TEMPERATURE, AND ROTATIONAL 
SPEED. (ROTATIONAL SPEED IS NOT REQUIRED) 

ERRORS 

NON-FATAL 

1. REQUIRED UNIT MEMBER NOT AVAILABLE. 

2. INSUFFICIENT LOCAL DYNAMIC STORAGE. 

3. MEMBER MANAGER ERROR OCCURRED ON SPECIFIED UNIT MEMBER. 

4. UNABLE TO INTERPOLATE SPECIFIED TABLE. 

5. SPECIFIED USER PARAMETER Ol'T OF RANGE. DEFAULT VALUE 
WILL BE USED. 

FATAL - NONE 

LDS REQUIREMENTS 

LENGTH = NTIMES * ( 21 + NWORDS ) + 1 

WHERE 

NTIMES - NUMBER OF SOURCE TIMES 
NWORDS - NUMBER OF WORDS PER RECORD ON MEMBER 
CONTAINING ENGINE VARIABLE DATA 


GDS REQUIREMENTS 

ALLOCATION REQUIRED FOR THE FOLLOWING TABLE(S) 

1. ENG(PRIM) 

2. ENG(SEC) (IF COMPUTING FOR A DUAL STREAM JET) 
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4»4»5 Airframe Noise Parameters Module (PREAFM) 


PURPOSE - TO GENERATE THE PARAMETERS REQUIRED TO 
EXECUTE THE AIRFRAME NOISE MODULE 

AUTHOR - CBF(L03/00/00) 

MMF(L03/00/09) 

input default 

USER PARAMETERS 

IPRINT - PRINTED OUTPUT OPTION 3 

0 - NO PRINT DESIRED 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

lUNITS - INPUT UNIT OPTION 2HSI 

2HSI. SI UNITS 
7HENGLISH, ENGLISH UNITS 

SCRXXX - THREE LETTER CODE XXX USED TO FORM THE 3HXXX 
UNIT MEMBER NAME FLI(FLIXXX). IF THE 
VALUE OF USER PARAMETER, SCRXXX 
IS 3HABC, THE FLI UNIT MEMBER NAME IS 
FLI(FLIABC). 

MEMBERS AND TABLES - DESCRIBED UNDER DATA BASE STRUCTURES 
FLI (FLI XXX) - (SEE USER PARAMETER SCRXXX) 

OUTPUT 

SYSTEM PARAMETER 

NERR - EXECUTIVE SYSTEM PARAMETER FOR ERROR ENCOUNTERED 
DURING EXECUTION OF A FUNCTIONAL MODULE 
=.TRUE., ERROR ENCOUNTERED 
=. FALSE., NO ERRORS ENCOUNTERED 


USER PARAMETERS 

NTIMES - NUMBER OF SOURCE TIME VALUES 
TIMES - MULTI-ELEMENT PARAMETER CONTAINING THE SOURCE 
TIMES 

LANDTG - MULTI-ELEMENT PARAMETER CONTAINING THE 
LANDING GEAR POSITION FOR EACH TIME 
( 4HD0WN OR 4HUP ) 

MTA - MULTI-ELEMENT PARAMETER CONTAINING THE AIRCRAFT 
MACH NUMBER FOR EACH TIME 
DELTATF- MULTI-ELEMENT PARAMETER CONTAINING THE 
FLAP SETTING, IN DEGREES, FOR EACH TIME 
CTA - MULTI-ELEMENT PARAMETER CONTAINING THE AMBIENT 
SPEED OF SOUND FOR EACH TIME 
RHOTA - MULTI-ELEMENT PARAMETER CONTAINING THE AMBIENT 
DENSITY FOR EACH TIME 
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Airframe Noise Parameters Module (PREAFM) 


MUTA - MULTI-ELEMENT PARAMETER CONTAINING THE 
AMBIENT DYNAMIC VISCOSITY FOR EACH TIME 

nATA ^TPIIPTIIPFQ 

FLI(FLIXXX) MULTI=ELEMENT MEMBER WITH F0RMAT»6RS,A4,2RS, 
WITH ONE RECORD PER SOURCE TIME CONTAINING 
THE FOLLOWING VALUES : (1) SOURCE TIME, (2) 
AIRCRAFT MACH NUMBER, (3) ENGINE POWER 
SETTING, (4) AMBIENT SPEED OF SOUND, (5) 
AMBIENT DENSITY, (6) AMBIENT DYNAMIC 
VISCOSITY, (7) LANDING GEAR POSITION, (8) 

FLAP SETTING, AND (9) ABSOLUTE HUMIDITY. 

THE FOLLOWING WORDS ARE USED IN THIS MODULE : 
(1) SOURCE TIME, (2) AIRCRAFT MACH NUMBER, 

(4) AMBIENT SPEED OF SOUND, (5) AMBIENT 
DENSITY, (6) AMBIENT DYNAMIC VISCOSITY, 

(7) LANDING GEAR POSITION, AND (8) FLAP 
SETTING, IN DEGREES. 

ERRORS 

NON- FATAL 

1. MEMBER MANAGER ERROR OCCURRED ON SPECIFIED UNIT MEMBER. 

2. INSUFFICIENT LOCAL DYNAMIC STORAGE. 

— EAIAL..— NONE 

LDS REQUIREMENTS 

LENGTH = ( NTIMES * ( NWORDS + ( NP - 1 ) ) + 1 ) 

WHERE 

NTIMES = NUMBER OF SOURCE TIMES 
NWORDS = NUMBER OF WORDS PER RECORD USED FROM MEMBER 
CONTAINING ENGINE VARIABLE DATA 
NP * NUMBER OF USER PARAMETERS OUTPUT FROM THIS 
MODULE 
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4.5.1 Propagation Module (PRO) 


PURPOSE - PRO IS THE ENTRY POINT FOR THE PROPAGATION 

MODULE. PRO TAKES NOISE DATA WHICH IS GENERATED BY 

SOURCE FRAME OF REFERENCE 
ALL OF THE APPROPIATE COMPUTATIONS TO 
TRANSFER IT TO THE OBSERVER FRAME OF REFERENcL^” 

AUTHOR - WKB(L03/00/00) 

WKB(L03/00/04) 

CBF(L03/00/05) 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS 


IPRINT 


I OUT 


SIGMA 


lUNITS 

NBAND 


RS 


SURFACE 


COH 

ABSORP 


GROUND 


OUTPUT PRINT OPTION CODE (INTEGER) 

»0 NO PRINTED OUTPUT 

=1 PRINT INPUT DATA ONLY 

=2 PRINT OUTPUT DATA ONLY 

*3 PRINT BOTH INPUT AND OUTPUT DATA (DEFAULT) 

=1 PRINT OUTPUT AS SOUND PRESSURE LEVEL. SPL. 

IN DECIBELS (INTEGER) 

=2 PRINT OUTPUT AS DIMENSIONLESS MEAN-SQUARE 
PRESSURE (DEFAULT) 

»3 PRINT OUTPUT IN BOTH FORMS 
SPECIFIC FLOW RESISTANCE OF THE GROUND. 

‘'^**3)) (REAL SG) 

(DEFAULT IS 2.5 * 10**5 KG/(S M**3)) 

“?SrL . » inputs are in SI UNITS (DEFAULT) 

*7HENGLISH, INPUTS ARE IN ENGLISH UNITS 
NUMBER OF SUBBANDS PER ONE-THIRD OCTAVE BAND 
(INTEGER) (DEFAULT IS 5) 

(NOTE. NBAND MUST BE ODD - E.G.. 1.3.5....) 
SOURCE RADIUS. M (FT) (REAL SINGLE ^ 

(DEFAULT IS 1.0 M) ’ 

USER SHOULD NOTE THAT RS VALUE MUST BE THE SAME 
NOISE®TABLEs'^°^^^ MODULES IN GENERATING THE 

EFfLtS CALCULATING GROUND 

»4HS0FT. NON HARD GROUND SURFACE (DEFAULT) 
»4HHARD. HARD GROUND SURFACE ^ ^ 

INCOHERENCE COEFFICIENT - DEFAULT IS .01 
=.TRUE. INCLUDE THE EFFECTS OF ATMOSPHERIC 
ABSORPTION 

•.FALSE. DO NOT INCLUDE THE EFFECTS OF 

ATMOSPHERIC ABSORPTION (DEFAULT) 

“.TRUE. INCLUDE GROUND EFFECTS ' ’ 

•.FALSE. DO NOT INCLUDE GROUND EFFECTS (DEFA'JlT) 



Propagation Module (PRO) 


PROTIME 


PROSUM 


THREE LETTER 10 (XXX) TO APPEND TO 3HFLI TO 
DEFINE THE UNIT MEMBER FLI(FLIXXX) THAT WAS 
GENERATED BY THE FLIGHT MODULE CONTAINING THE 
SOURCE TIMES TO BE USED BY THE NOISE MODULES. 

THIS ID ALSO BECOMES THE FIRST THREE CHARACTERS 
OF EACH TABLE (ONE TABLE FOR EACH SOURCE TIME) 
MEMBER THAT IS GENERATED BY A NOISE MODULE. FOR 
EXAMPLE. IF THE VALUE OF PARAMETER PROTIME IS 
3HF01. THEN THE SOURCE TIMES ARE WRITTEN ON 
UNIT MEMBER FLI(FLIFOl) BY THE FLIGHT MODULE. 

IF THERE ARE 20 SOURCE TIMES ON UNIT MEMBER 
FLI(FLIFOl), THEN THERE ARE 20 TABLES GENERATED 
FOR EACH NOISE MODULE CALLED AND THE MEMBER NAMES 
FOR THESE TABLES ARE THE SAME FOR ALL NOISE 
SOURCES WITH ONLY THE UNIT NAME BEING DIFFERENT. 
FOR THIS EXAMPLE, IF NOISE MODULES FAN AND CORE 
ARE CALLED, THE TABLES ARE ON UNfT MEMBERS 
FAN(FOIOOI), FAN(F01002), ... FAN(F01020), 
CORE(FOIOOI), CORE (FO 1002),.. C0RE(F01020) . 
DEFAULT IS 3HXXX. 

CONTAINS THE NAMES OF SOURCE UNITS THAT ARE TO 
BE SUMMED BEFORE PROPAGATION. IF THE NOISE DATA 
FROM THE CORE AND FAN MODULES ARE TO BE SUMMED, 
THEN PROSUM WILL CONTAIN TWO ELEMENTS - 4HC0RE 


AND 4HFAN . 

DATA BASE UNITS AND MEMBERS 

ATM(TMOD) TYPE 1 TABLE CONTAINING ATMOSPHERIC 

PROPERTIES (SEE MODULE ATM) 
INDEPENDENT VARIABLES 


ATM(AAC) 


1. ALTITUDE 

2. ORDERED POSITION 

DEPENDENT VARIABLES IN THE FOLLOWING 
ORDERED POSITION 

1. PRESSURE 

2. DENSITY 

3. TEMPERATURE 

4. SPEED OF SOUND 

5. AVERAGE SPEED OF SOUND 

6. HUMIDITY 

7. COEFFICIENT OF VISCOSITY 

8. COEFFICIENT OF THERMAL CONDUCTIVITY 

9. CHARACTERISTIC IMPEDANCE (RHO*C) 
TYPE 1 TABLE CONTAINING ATMOSPHERIC 
ABSORPTION COEFFICIENTS (SEE MODULE ABS) 

INDEPENDENT VARIABLES 

1. ALTITUDE 

2. FREQUENCY 


4-36 






.? . .o 






original r‘AC;L* !3 

OF POOR QUAl’itY 
Propagation Module (PRO) 


GEO(GEON) GEOMETRY DATA FOR ALL OBSERVERS RELATIVE 

TO ONE NOISE SOURCE COORDINATE SYSTEM 

““ structures. 

FLI(FLIXXX) FLIGHT DATA CONTAINING SOURCE TIMES USED 

S! lul modules, the XXX IS REPLACED 

BY THE ID FOUND IN PARAMETER PROTIME. 

vyvvvv^¥vynmm\ nil STRUCTURES) 

YYYYYY(XXXNNN) TYPE 1 TABLE CONTAINING DIMENSIONLESS MEAN 

SOUARE PRESSURE. THE YYYYYY IS THE UNIT 
NAME ASSOCIATED WITH A NOISE MODULE (E.G.. 
FAN OR CORE ). THE XXX IS THE ID FOUND IN 
PARAMETER PROTIME. THE NNN IS A COUNTER 
STARTING AT 001 AND CONTINUING FOR THE 
NUMBER OF SOURCE TIMES. THERE IS ONE 
TABLE PER SOURCE TIME. IF THERE ARE 
TWENTY SOURCE TIMES* THEN THERE ARE 
TWENTY TABLES FOR EACH NOISE MODULE. 
INDEPENDENT VARIABLES 

1. FREQUENCY, HZ 

2. POLAR DIRECTIVITY ANGLE, DEG 

3. AZIMUTHAL DIRECTIVITY ANGLE, DEG 


OUTPUT 

USER PARAMETERS 
NERR 


».TRUE. , ERROR ENCOUNTERED, PRO 
TERMINATED ABNORMALLY 
=. FALSE., NO ERRORS ENCOUNTERED, PRO 
TERMINATED SUCCESSFULLY 


DATA BASE UNITS AND MEMBERS 

PRO(PRES) DIMENSIONLESS MEAN SQUARE PRESSURE AT THE 

OBSERVER AS A FUNCTION OF FREQUENCY AND 
TIME. (SEE DESCRIPTION IN DATA BASE 
STRUCTURES.) 

SCRATCH(XXXNNN) UNIT SCRATCH CONTAINS THE RESULT OF SUMMING 

DATA BASE STRUCTURES 
THE FORMAT OF GEO(GEOM) IS AS FOLLOWS: 


RECORD 

1 


WORD 

1 

2 

3 

4 

5 


DESCRIPTION 

RECORD FORMAT IS I,3RS,I,RS 
OBSERVER INDEX FOR FIRST OBSERVER 
X COORDINATE OF OBSERVER 
Y COORDINATE OF OBSERVER 
Z COORDINATE OF OBSERVER 
NUMBER OF RECEPTION TIMES ASSOCIATED WITH 
THIS OBSERVER (ASSUME VALUE IS N) 
OBSERVER'S HEIGHT 
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2 RECORD FORMAT IS *RS 

! RECEPTION TIMES ..EOR.XURR£NT OBSERVER 
. INDEX 

N 

RECORDS 3 THROUGH N+2 CONTAIN GEOMETRY DATA FOR EACH 
RECEPTION TIME. RECORD 3 CONTAINS GEOMETRY DATA FOR 
THE FIRST RECEPTION TIME, RECORD 4 FOR THE SECOND 
RECEPTION TIME,... RECORD N+2 FOR THE N TH RECEPTION 
TIME. 

3 RECORD FORMAT IS *RS 

1 DISTANCE OF SOURCE FROM OBSERVER 

2 EMISSION TIME, SEC 

3 DIRECTIVITY ANGLE, DEG 

4 ELEVATION ANGLE, DEG 

5 AZIMUTH ANGLE, DEG 

4 REPEAT OF RECORD 3 FOR SECOND RECEPTION TIME 


N+3 RECORD FORMAT IS I,3RS,I,RS 

1 OBSERVER INDEX FOR SECOND OBSERVER 

2 X COORDINATE OF OBSERVER 

3 Y COORDINATE OF OBSERVER 

4 Z COORDINATE OF OBSERVER 

5 NUMBER OF RECEPTION TIMES ASSOCIATED WITH 
THIS OBSERVER (ASSUME VALUE IS M) 

N+4 RECORD FORMAT IS *RS 

1 

. RECEPTION TIMES FOR CURRENT OBSERVER 

. INDEX 

M 

RECORD N+5 THROUGH RECORD N+M+4 CONTAIN GEO'iETRY DATA 
FOR EACH RECEPTION TIME STORED IN THE SAME f^ANNER AS 
DESCRIBED ABOVE IN RECORDS 3 THROUGH N+2. 


THE PATTERN AS SEEN IN RECORDS 1 THROUGH N+2 AND RECORDS 
N+3 THROUGH N+M+4 CONTINUES FOR ALL OBSERVERS 
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THE FORMAT OF FLI(FLIXXX) IS AS FOLLOWS: 

RECORD WORD DESCRIPTION 

1 RECORD FORMAT IS *RS 

1 VALUE OF FIRST SOURCE TIME 

2 MACH NUMBER 

3 POWER SETTING 

4 AMBIENT SPEED OF SOUND 

5 DENSITY 

6 VISCOSITY 

7 LANDING GEAR INDICATOR 

8 FLAP SETTING 

9 HUMIDITY 

2 RECORD FORMAT IS *RS 

. SAME INFORMATION AS IN RECORD 1 EXCEPT 

FOR THE SECOND SOURCE TIME 

3 


THE FORMAT OF PRO(PRES) IS AS FOLLOWS: 


RECORD WORD DESCRIPTION 

1 RECORD FORMAT IS I,*A8 

1 NUMBER OF NOISE SOURCES PROPAGATED TO 
THE OBSERVERS. NS. 

2-(NS+l) MODULE NAMES OF NOISE SOURCES PROPAGATED 
TO THE OBSERVERS 


2 


3 


RECORD FORMAT IS 2I,2RS 

1 OBSERVER INDEX FOR THE FIRST OBSERVER 

2 NUMBER OF RECEPTION TIMES ASSOCIATED WITH 
THIS OBSERVER (ASSUME VALUE IS N) 

3 AIR DENSITY AT THE OBSERVER (RE RHO ) 

4 SPEED OF SOUND AT THE OBSERVER (RE C ) 

R 

RECORD FORMAT IS *RS 

1 

. RECEPTION TIMES FOR CURRENT OBSERVER 

. INDEX 

N 


Propagation Module (PRO) 


4 RECORD FORMAT IS *RS 

1 DIMENSIONLESS MEAN SQUARE PRESSURE FOR 
THE FIRST FREQUENCY AND THE FIRST 
RECEPTION TIME 

2 DIMENSIONLESS MEAN SQUARE PRESSURE FOR 
THE SECOND FREQUENCY AND THE FIRST 
RECEPTION TIME 


NF DIMENSIONLESS MEAN SQUARE PRESSURE FOR 
THE LAST FREQUENCY AND THE FIRST 
RECEPTION TIME 


5 RECORD FORMAT IS *RS 

I DIMENSIONLESS MEAN SQUARE PRESSURE FOR 

. ALL FREQUENCIES FOR THE SECOND 
. RECEPTION TIME 

NF 

6 RECORD FORMAT IS *RS 

1 DIMENSIONLESS MEAN SQUARE PRESSURE FOR 

. ALL FREQUENCIES FOR THE THIRD 
. RECEPTION TIME 

NF 


N+4 SAME AS RECORD 2 BUT DATA IS FOR SECOND 
OBSERVER 

N+5 SAME AS RECORD 3 BUT DATA IS FOR SECOND 
OBSERVER 

RECORDS 2 THROUGH N+3 REPEAT FOR ALL OBSERVERS. THE 
VALUE OF N DIFFERS FOR EACH OBSERVER. 


ERRORS 

NON-FATAL 

FUNCTIONAL MODULE ERRORS 
—1. REQUIRED UNIT MEMBER NOT AVAILABLE 

2. INSUFFICIENT LDS DYNAMIC STORAGE 

3. UNIT MEMBER NOT OF CORRECT FORMAT 

4. MEMBER MANAGER ERROR OCCURRED ON READING OR OPENING 
A UNIT MEMBER 

5. REQUIRED USER PARAMETER PROSUM IS TYPE — WITH — 

- EXPECTED TYPE ALPHA AND THE NUMBER OF ELEMENTS 
.LE. 10. 
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6. UNABLE TO INTERPOLATE TABLE — - FOR VALUES 

7. ERROR ENCOUNTERED IN BUILDING TABLE 

PRO MODULE ERRORS 

1. TABLES OF NOISE SOURCES TO BE SUMMED ARE NOT 
COMPATIBLE 


FATAL - NONE 


LOS REQUIREMENTS 

LENGTH » 3*NFREQ ♦ NB + 6*NB*NFREQ 

WHERE NFREQ = NUMBER OF FREQUENCIES 

NB s VALUE OF USER PARAMETER "NBAND" 

GDS REQUIREMENTS 


ALLOCATION REQUIRED FOR THE FOLLOWING TABLES: 

1. ATM(TMOO) 

2. ATN(AAC) ( IF USER PARAMETER "ABSORP'' IS .TRUE. ) 

• SIS that are to be 

SUMMED PLUS ONE 


4.5,2 General Suppression Module (6ENSUP) 


PURPOSE - TO APPLY A NOISE SUPPRESSION FACTOR TO A NOISE TABLE 
PRODUCED BY ANY ANOPP NOISE SOURCE MODULE 

AUTHOR - CBF(L03/00/00) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS DEFAULT 

SCRXXX - THREE LETTER CODE, XXX, USED TO FORM 3HXXX 

OUTPUT TABLE MEMBER NAME, NOISES (XXXNNN) 

SCRNNN - INTEGER VALUE, NNN, .GT. 0 USED TO FORM 

OUTPUT TABLE MEMBER NAME, NOISES (XXXNNN) 001 

IPRINT - PRINT FLAG (I) 3 

»0, NO PRINT DESIRED 
=1, INPUT PRINT ONLY 
»2, OUTPUT PRINT ONLY 


RHOA 

=3, BOTH INPUT AND OUTPUT PRINT 
- AMBIENT DENSITY (RS), KG/M**3 

1.22S 

CA 

(SLUG/FT**3) 

- AMBIENT SPEED OF SOUND (RS), M/S 

340.294 

I OUT 

(FT/SEC) 

- OUTPUT CODE ( FOR TABLE AND/OR 

3 


PRINTED OUTPUT ) 



0 NO PRINT, BUT GENERATE TABLE 
NOISES(XXXNNN) 

-1 PRINT OUTPUT IN OB UNITS. BUT DO 
NOT GENERATE TABLE NOISES( XXXNNN) 

-2 PRINT OUTPUT IN DIMENSIONLESS UNITS, 

BUT DO NOT GENERATE TABLE 
NOISES(XXXNNN) 

-3 BOTH OPTIONS -1 AND -2 

1 PRINT OUTPUT IN DB UNITS AND 
GENERATE TABLE NOISES( XXXNNN) 

2 PRINT OUTPUT iN DIMENSIONLESS UNITS 

AND GENERATE TABLE NOISES( XXXNNN) 

3 BOTH OPTIONS 1 AND 2 

lUNITS - INPUT UNITS FLAG SI 

2HSI, SI UNITS 
7HENGLISH, ENGLISH UNITS 

DATA BASE UNIT MEMBERS 

(DESCRIBED UNDER DATA BASE STRUCTURES) 

NOISE (XXXNNN) NOTE MEMBER NAME XXXNNN IS FORMED FROM 
USER PARAMETERS SCRXXX AND SCRNNN. 

SUPPRESS( FACTOR) 
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OUTPUT 

SYSTEM PARAMETERS 
NERR - ERROR FLAG 

.TRUE., IMPLIES AN ERROR WAS ENCOUNTERED 
DURING MODULE EXECUTION 
.FALSE., NO ERROR ENCOUNTERED 

DATA BASE UNIT MEMBERS 

NOISES (XXXNNN) SEE FORMAT UNDER DATA BASE STRUCTURES. 

NOTE MEMBER NAME XXXNNN IS FORMED FROM 
USER PARAMETERS SCRXXX AND SCRNNN. 


DATA RA^F 

NOISE (XXXNNN) TYPE 1 TABLE CONTAINING MEAN SQUARE 
ACOUSTIC PRESSURE AS A FUNCTION OF 

(1) FREQUENCY, (2) DIRECTIVITY ANGLE 

AND (3) AZIMUTHAL ANGLE. SEE INFORMATION 
ON OVERRIDING THIS UNIT NAME UNDER 
DESCRIPTION OF NOISES( XXXNNN). 

SUPPRESS( FACTOR) TYPE 1 DATA TABLE CONTAINING A SUPPRESSION 
FACTOR AS A FUNCTION OF (1) FREQUENCY, 

(2) DIRECTIVITY ANGLE AND (3) AZIMUTHAL 
ANGLE 

NOISES (XXXNNN) TYPE 1 TABLE CONTAINING SUPPRESSED MEAN 
SQUARE ACOUSTIC PRESSURE AS A FUNCTION 
OF (1) FREQUENCY, (2) DIRECTIVITY ANGLE, 

AND (3) AZIMUTH ANGLE. WHEN OVERRIDING 
THIS UNIT NAME, THE NAME OF THE UNIT MUST 
BE THE SAME AS THE NAME OF THE UNIT CONTAIN- 
ING THE INPUT NOISE TABLE WITH AN 'S' ON 
THE END. EXAMPLE (1) : SUPPOSE THE UNIT 
CONTAINING THE INPUT NOISE TABLE IS 'DATE'. 
THE NAME OF THE UNIT CONTAINING THE OUTPUT 
NOISE TABLE WILL BECOME 'DATES'. EXAMPLE 
(2): SUPPOSE THE UNIT CONTAINING THE OUTPUT 
NOISE TABLE IS OVERRIDEN TO BECOME 'STORES' 
THEN THE UNIT CONTAINING THE INPUT NOISE 
TABLE MUST BE OVERRIDEN TO BE 'STORE'. 
EXAMPLE (3) : IF THE INPUT UNIT IS TO BE 
'TABLE', THEN TO OVERRIDE THIS OUTPUT UNIT 
TO BE SOMETHING OTHER THAN 'TABLES', THE 
FOLLOWING MUST BE DONE. FOR EXAMPLE, THE 
INPUT UNIT IS 'TABLE'; THE OUTPUT UNIT IS 
TO BE 'STORE'. OVERRIDE 'NOISE' TO BE 
'TABLE' AND OVERRIDE 'TABLES' TO BE 'STORE' 


General Suppression Module (GENSMP) 


ERRORS 

NON-FATAL 

1. INSUFFICIENT DYNAMIC STORAGE. 

2. INTERPOUTIOli ERROR ON INPUT NOISE TABLE. 

3. INVALID VALUE FOR INPUT USER PARAMETER. DEFAULT 
VALUE MILL BE USED. 

4. ERROR IN BUILDING OUTPUT TABLE OF SUPPRESSED NOISE. 
FATAL - NONE 

LOS REQUIREMENTS 

LENGTH ° ( 2 * NFREQ ) + NTHETA + NPHI ♦ NINT + 

( NTHETA * NPHI ) * ( 1 + NFREQ ) 

WHERE s 

NFREQ » NUMBER OF FREQUENCY VALUES ON INPUT AND OUTPUT 
NOISE TABLES 

NTHETA = NUMBER OF DIRECTIVITY ANGLE VALUES ON INPUT 
AND OUTPUT NOISE TABLES 

NPHI = NUMBER OF AZIMUTH ANGLE VALUES ON INPUT AND 
OUTPUT NOISE TABLES 

NINT » NUMBER OF VALID INTERPOLATION PROCEDURES FOR 
THE INPUT AND OUTPUT NOISE TABLES 


GDS REQUIREMENTS 

SUFFICIENT ALLOCATION FOR THE FOLLOWING TABLES 

1. NOISE (XXXNNN) 

2. SUPPRESS(FACTOR) 

3. NOISES (XXXNNN) 
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4.6 RECEIVED NOISE 
4.6.1 Noise Levels Module (LEV) 


PURPOSE - TO COMPUTE OVERALL SOUND PRESSURE LEVEL, A-WEI6HTED 
SOUND PRESSURE LEVEL, 0-WEI6HTED SOUND PRESSURE 
LEVEL, PERCEIVED NOISE LEVEL. AND TONE CORRECTED 
PERCEIVED NOISE LEVEL AS FUNCTIONS OF TIME AND 
OBSERVER 

AUTHOR - CBF(L03/00/00) 

CBF(L03/00/04 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS DEFAULT 

lAWT - A-WEIGHTED SOUND PRESSURE LEVEL OPTION F 

IDWT - D-WEIGHTED SOUND PRESSURE LEVEL OPTION F 

lOSPL - OVERALL SOUND PRESSURE LEVEL OPTION F 

IPNL - PERCEIVED NOISE LEVEL OPTION F 

IPNLT - TONE-CORRECTED PERCEIVED NOISE LEVEL OPTION T 

( THE ABOVE OPTION CODES HAVE THE FOLLOWING VALUES ) 

( .TRUE. - COMPUTE ) 

( .FALSE. - DO NOT COMPUTE ) 

lUNITS - INPUT UNIT OPTION 2HSI 

*2HSI, SI UNITS 
*7HEN6LISH, ENGLISH UNITS 

IPRINT - PRINTED OUTPUT OPTION 3 

0 - NO PRINT DESIRED 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

MEMSUM - CONTAINS THE UNIT NAME AND MEMBER NAME OF THE 

NOISE MEMBERS TO BE SUMMED ( CONTAINS .LE.-20 

ELEMENTS, IE. .LE. 10 NOISE MEMBERS ) 

MEMBERS - DESCRIBED UNDER DATA BASE STRUCTURES 
NOTE : MEMBERS ARE SPECIFIED BY UNIT(MEMBER) NAME 
SFIELO(FREQ) 

OBSERV(COORO} 

XXXXXX(YYYYYY) 


OUTPUT 

SYSTEM PARAMETER 

NERR EXECUTIVE SYSTEM PARAMETER FOR ERROR ENCOUNTERED 
DURING EXECUTION OF A FUNCTIONAL MODULE. NERR SET 
TO .TRUE. IF ERROR ENCOUNTERED 


MEMBERS 

LEV(PNLT) 
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DATA RA^P ^TRlirTlIOPC 

OBSERV(COORD) MULTI-RECORD MEMBER WITH FORMAT - 3RS, 
CONTAINING ONE RECORD FOR EACH OBSERVER 
WITH VALUES OF THE X,V,Z COORDINATES 
1 RECORD MEMBER IN *RS FORMAT CONTAINING 
REAL SINGLE VALUES OF FREQUENCIES IN HZ 
XXXXXX IS THE UNIT NAME AND YYYYYY IS THE 
MEMBER NAME OF AN UNFORMATTED MULTI-RECORD 
NOISE MEMBER. THESE UrilT AND MEMBER NAMES 
ARE ELEMENTS OF USER PARAMETER, MEMSUM. 

ONE OR MORE NOISE MEMBERS WILL BE INPUT TO 
LEV TO BE SUMMED. THE NOISE MEMBERS HAVE 
THE FOLLOWING FORMAT: 

RECORD FORMAT DESCRIPTION 


SFIELD(FREQ) 
XXXXXX( YYYYYY) 


1 

2 


3 

4 


I,*A8 

2I,2RS 


*RS 

*RS 

*RS 


NO. OF NOISE SOURCES, ARRAY OF SOURCES 
OBSERVER INDEX, NUMBER OF OBSERVER 
TIMES* AMBIENT DENSITY, AMBIENT SPEED OF 
SOUND 

ARRAY OF OBSERVER TIMES 

MEAN SQUARE PRESSURE FOR EACH FREQUENCY 

FOR FIRST TIME 

MEAN SQUARE PRESSURE FOR EACH FREQUENCY 
FOR SECOND TIME . 


1+M* (WHERE M IS THE NUMBER OF OBSERVERS AND 

(2+N) N IS THE NUMBER OF OBSERVER TIMES. 

NOTE: N IS DIFFERENT FOR EACH OBSERVER) 

LEV(PNLT) UNFORMATTED MULTI-RECORD OUTPUT MEMBER IN 

THE FOLLOWING FORMAT OF A HEADER RECORD AND 
THREE RECORDS PER OBSERVER 
RECORD FORMAT DESCRIPTION 

1 I,*A8 NO. OF NOISE SOURCES, ARRAY Of"sOURCES** 

2 21 OBSERVER INDEX, NO. OF TIMES 

3 *RS ARRAY OF TIMES 

4 *RS ARRAY OF TONE-CORRECTED PERCEIVED NOISE 

LEVEL FOR ALL TIMES 


1+3*M 


(WHERE M IS THE NUMBER OF OBSERVERS) 
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Noise Levels Module (LEV) 


ERRORS 

NON-FATAL 

(FMNM^lERROrAr’^^’^ OCCURRED ON SPECIFIED UNIT MEMBER 

2. INSUFFICIENT DYNAMIC STORAGE. (FMNMSG ERROR 2) 

A* ^^QOTRED user parameter not available, (FMNMSG ERROR 5) 

4. REQUIRED USER PARAMETER TYPE OR NUMBER OF ELEMENTS IS 
INVALID. (FMNMSG ERROR 6) tLtntNii is 

FATAL - NONE 
LDS REQUIREMENTS 

LENGTH = NFREQ * ( 2+NMEM ) + LONGESTREC + NS 


WHERE NFREQ 
NMEM 


LONGESTREC « 


NUMBER OF FREQUENCY VALUES 
NUMBER OF NOISE MEMBERS TO BE 
SUMMED 

LENGTH OF THE LONGEST RECORD OF 
THE NOISE MEMBERS 
TOTAL NUMBER OF NOISE SOURCES 
READ FROM THE FIRST RECORD OF THE 
INPUT NOISE MEMBERS 



4,6.2 Effective Noise Modu1e-f£FF) 


PURPOSE - TO COMPUTE EFFECTIVE PERCEIVED NOISE LEVEL (EPNL) 

AS A FUNCTION OF OBSERVER POSITION 

AUTHOR - CBF(L03/00/00) 

CBF(L03/00/04) 

INPUT 

USER PARAMETERS DEFAULT 

DTIME - RECEPTION TIME INCREMENT (S) .5 

IPRINT - PRINTED OUTPUT OPTION 3 

0 - NO PRINT DESIRED 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

MEMBERS • DESCRIBED UNDER DATA BASE STRUCTURES 
NOTE : MEMBERS ARE SPECIFIED BY UNIT(MEMBER) NAME 
OBSERV(COORD) 

LEVL(PNLT) 


OUTPUT 

SYSTEM PARAMETER' 

NERR - EXECUTIVE SYSTEM PARAMETER FOR ERROR ENCOUNTERED 
DURING EXECUTION OF A FUNCTIONAL MODULE. NERR SET 
TO .TRUE. IF ERROR ENCOUNTERED 

MEMBERS 

EFF(EPNL) 

DATA RA^P ^TRIirTlIRPQ 

OBSERV(COORD) MULTI-RECORD MEMBER WITH FORMAT * 3RS, 
CONTAINING ONE RECORD FOR EACH OBSERVER 
WITH VALUES OF THE X,Y,Z COORDINATES 
LEV(PLNT) UNFORMATTED MULTI-RECORD MEMBER IN 

THE FOLLOWING FORMAT OF A HEADER RECORD 
FOLLOWED BY THREE RECORDS PER OBSERVER 
RECORD FORMAT DESCRIPTION 


1 I,*A8 NO. OF NOISE SOURCES, ARRAY OF NOISE 

SOURCE S 

OBSERVER INDEX, NO. OF TIMES 
ARRAY OF TIMES 

ARRAY OF TONE-CORRECTED PERCEIVED NOISE 
LEVEL FOR ALL TIMES 


(WHERE M IS THE NUMBER OF OBSERVERS) 


2 21 

3 *RS 

4 *RS 


1+3*M 
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M 


EFF(EPNL) UNhORMATTEO MULTI-RECORD OUTPUT MEMBER IN 

THE FOLLOWING FORMAT OF A HEADER RECORD 
FOLLOWED BY A RECORD FOR EACH OBSERVER 
CONTAINING THE OBSERVER INDEX AND EPNL 
VALUE 

RECORD FORMAT DESCRIPTION 


I,*A8 NO. OF SOURCES. ARRAY OF NOISE SOURCES 
I,RS OBSERVER INDEX, EFFECTIVE PERCEIVED 
NOISE LEVEL (EPNL) 


(WHERE N IS THE NUMBER OF OBSERVERS) 


1. INSUFFICIENT DYNAMIC STORAGE (FMNMSG ERROR 2) 

2. MEMBER MANAGER ERROR OCCURRED ON SPECIFIED UNIT MEMBER. 
(FMNMSG ERROR 4) 

LDS REQUIREMENTS 

LENGTH = 12 * NOBS + NS 

WHERE NOBS = NUMBER OF OBSERVERS 

NS = NUMBER OF NOISE SOURCES 


1 

2 


N+1 


ERRORS 

NON-FATAL 


4-49 


4.7 UTILITIES 


The modules for the ANOPP utilities were not available at Level 03/00/00. 


4.8 NOISE SOURCES 
4.8.1 Fan Noise Module (HDNFAN) 


PURPOSE - PREDICT THE BROADBAND NOISE AND PURE TONES FOR AN 
AXIAL FLOW COMPRESSOR OR FAN BY THE HEIDMAN METHOD 
REFERENCE - NASA TM X-71763, INTERIM PREDICTION 
METHOD FOR FAN AND COMPRESSOR SOURCE NOISE, M. F. 
HEIDMAN 


AUTHOR - CBF(L03/00/00) 
CBF(L03/00/04) 
MMF(L03/00/09) 


INPUT 

USER PARAMETERS 

AE ENGINE REFERENCE AREA (RS), 

M^*2 (FT**2) 

RS DISTANCE FROM SOURCE TO OBSERVER 

(RS), M (FT) 

AFAN FAN INLET CROSS-SECTIONAL AREA (RS), 

RE AE 

DIAM FAN ROTOR DIAMETER (RS), 

RE SQRT(AE) 

MD FAN ROTOR RELATIVE TIP MACH NUMBER AT 

DESIGN POINT (RS) 

RSS ROTOR-STATOR SPACING (RS), 

RE MEAN ROTOR BLADE CHORD 
MDOT MASS FLOWRATE (RS), 

RE RHOA * CA * AE 

MA AIRCRAFT MACH NUMBER (RS) 

N ROTATIONAL SPEED (RS), 

RE CA/DIAM 

DELTAT TOTAL TEMPERATURE RISE ACROSS FAN (RS). 
RE TA 

CA AMBIENT SPEED OF SOUND (RS), 

M/S (FT/S) 

RHOA AMBIENT DENSITY (RS). 

KG/M**3 (SLUG/FT**3) 

NBANDS NUMBER OF 1/3 OCTAVE BANDS FOR TONE 
FREQUENCY SHIFT (I) 

NENG NUMBER OF ENGINES (I) 

NB NUMBER OF ROTOR BLADES (I) 

NV NUMBER OF STATOR VANES (I) 

IGV INLET GUIDE VANE INDEX (I) 

1, FOR A FAN WITH NO INLET GUIDE VANES 

2, FOR A FAN WITH INLET GUIDE VANES 

DIS INLET FLOW DISTORTION INDEX (I) 

1, IF THERE IS NO INLET FLOW 
DISTORTION 

2. IF THERE IS INLET FLOW 
DISTORTION 


DEFAULT 

SL-UNITS 

PI/4 

SQRT(AE) 

1 . 

1.128 


1.0 


1.0 


.2 


0 . 

.3 

.2 

340.294 

1.225 

0 


1 

20 

50 

1 


1 
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STIME 

lOUT 


IPRINT 


SCRNNN 

SCRXXX 

lUNITS 


(THE NEXT 

(.FALSE. 

(.TRUE. 

INRS 

INCT 

INDIS 

IDBB 

IDRS 

INBB 


SOURCE TIME (RS) ^ 

TABLE OUTPUT AND PRINT OUTPUT OPTION (I) 3 

0 NO PRINT BUT GENERATE TABLE 
HDNFAN (XXXNNN) 

-1 PRINT OUTPUT IN DB UNITS, BUT DO 
NOT GENERATE TABLE HDNFAN(XXXNNN) 

-2 PRINT OUTPUT IN DIMENSIONLESS FORM 
BUT DO NOT GENERATE TABLE HDNFAN 
(XXXNNN) 

-3 BOTH OPTIONS -1 AND -2 

1 PRINT OUTPUT IN OB UNITS AND 
GENERATE TABLE HDNFAN(XXXNNN) 

2 PRINT OUTPUT IN DIMENSIONLESS FORM 
AND GENERATE TABLE HDNFAN(XXXNNN) 

3 BOTH OPTIONS 1 AND 2 

PRINT FLAG (I) 3 

0 NO PRINT DESIRED 

1 INPUT PRINT ONLY 

2 OUTPUT PRINT ONLY 

3 BOTH INPUT AND OUTPUT PRINT 

INTEGER VALUE, NNN, .6T. 0 USED TO FORM 001 
TABLE UNIT MEMBER NAME HDNFAN(XXXNNN) 

THREE LETTER CODE XXX USED TO FORM 3HXXX 

TABLE UNIT MEMBER NAME HDNFAN(XXXNNN) 

INPUT UNITS FLAG 2HSI 

7HEN6LISH. ENGLISH UNITS 
2HSI, SI UNITS 


SIX COOES HAVE THE FOLLOWING VALUES) 

- DO NOT INCLUDE ) 

- INCLUDE IN TOTAL PREDICTION ) 

INLET ROTOR-STATOR INTERACTION TONES 
COMBINATION TONE NOISE 

INLET FLOW DISTORTION TONES 
DISCHARGE BROADBAND NOISE 
DISCHARGE ROTOR-STATOR INTERACTION TONES 
INLET BROADBAND NOISE 


T 

T 

T 

T 

T 

T 


DATA BASE UNIT MEMBERS 

(DESCRIBED UNDER DATA BASE STRUCTURES) 
SFIELD(FREQ) 

SFIELD(THETA) 

SFIELD(PHI) 


OUTPUT 

USER PARAMETERS 

RS DISTANCE FROM 


SOURCE TO OBSERVER 
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SYSTEM PARAMETERS 

'"““"tereo 

.FALSE., NO ERROR ENCOUNTERED 
DATA BASE UNIT MEMBERS 

HDNFAN(XXXNNN) see format unoer data base structures 

name xxxnnn is formed 

STTsEV^AiErenSu}! 

DATA BASE STRUCTURES 

SFIELD(FREQ) - 1 RECORD MEMBER IN *RS FORMAT 

CONTAINING VALUES OF 1/3 OCTAVE BAND 
CENTER FREQUENCIES IN HZ 
1 RECORD MEMBER IN ^S FORMAT 
CONTAINING VALUES OF THE POLAR 
DIRECTIVITY ANGLE IN DEG 
1 RECORD MEMBER IN *RS FORMAT 
CONTAINING VALUES OF THE AZIMUTHAL 
DIRECTIVITY ANGLE IN DEG 


SFIELO(THETA) 
SFIELO(PHI) 
HDNFAN( XXXNNN) - 


ERRORS 

NON-FATAL 

2* O'^NAMIC storage. 

MEMBER. OCCURRED ON SPECIFIED UNIT 
FATAL - NONE* 

REMARKS 

REFERENCES 

interim PREDICTION METHOD FOR FAN 
W COMPRESSOR SOURCE NOISE, NASA Tx-TITB*!! 

IDS REQUIREMENTS 

LENGTH - (NFREQ * NTHETA • NPHI) * (NTHETA » NPHI) 

: Nm?A* *"""* * * ^ * ( Nfwo * iItheta ) 

WHERE 

nt2fta “ ’^'^^OUENCY VALUES 

NTHETA = NUMBER OF DIRECTIVITY ANGLES 

NPHI » NUMBER OF AZIMUTHAL AnS 
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4«8,2 Combustion Noise Module fGECOR) 


PURPOSE - 


AUTHOR - 


INPUT 

USER PARAMETERS yypE DEFAULT 


AE 

ENGINE REFERENCE AREA. 
M**2 (FT**2) 

RS 

(SI) 

PI/4 

A 

COMBUSTOR ENTRANCE AREA 

DIMENSIONLESS 

RE ENGINE REFERENCE AREA 

RS 

1.0 

NENG 

NUMBER OF ENGINES 

I 

1 

RS 

DISTANCE FROM SOURCE TO OBSERVER 

RS SORTIAEI 

MDOT 

COMBUSTOR ENTRANCE MASS FLOWRATE 

DIMENSIONLESS 

RE RHOA*CA*AE 

RS 

^ — 0 

.2 

MA 

AIRCRAFT MACH NUMBER 

RS 

0.0 

PI 

COMBUSTOR ENTRANCE TOTAL PRESSURE 

DIMENSIONLESS 

RE AMBIENT PRESSURE 

RS 

1.0 

TI 

COMBUSTOR ENTRANCE TOTAL 
TEMPERATURE 
DIMENSIONLESS 
RE AMBIENT TEMPERATURE 

RS 

1.0 

TJ 

COMBUSTOR EXIT TOTAL TEMPERATURE 

DIMENSIONLESS 

RE AMBIENT TEMPERATURE 

RS 

2.0 

TDDELT 

DESIGN TURBINE TEMPERATURE RISE 

DIMENSIONLESS 

RE AMBIENT TEMPERATURE 

RS 

0.5 

CA 

AMBIENT SPEED OF SOUND, 
M/S (FT/SEC) 

RS 

340.294 

RHOA 

AMBIENT DENSITY. 
KG/M**3 (SLU6/FT**3) 

RS 

1.225 

STIME 

SOURCE TIME AT WHICH NOISE IS 
CALCULATED 

RS 

0.0 

ICA078 

IF .TRUE., USE THE SAE ARP 876 
ENVELOPE SPECTRUM FUNCTION AS A 
REPLACEMENT FOR THE SPECTRAL 
DISTRIBUTION FUNCTION. IF 
.FALSE., THE REGULAR SPECTRAL 
DISTRIBUTION FUNCTION IS USED 

L 

.FALSE. 


6EC0R PREDICTS THE NOISE FROM CONVENTIONAL COMBUSTORS 
INSTALLED IN GAS TURBINE ENGINES^ THE METHOD IS 
BASED ON A PROPOSED APPENDIX TO THE SOCIETY OF 
AUTOMOTIVE ENGINEERS (SAE) AEROSPACE RECOMMENDED 
PRACTICE (ARP) NUMBER 876. 

WKB(L03/00/00) 

MMF(L03/00/09) 
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SCRXXX THREE LETTER CODE XXX USED TO FORM A 3HXXX 

TABLE UNIT MEMBER NAME 
GECOR(XXXNNN). SEE USER PARAMETER 
SCRNNN 

SCRNNN INTEGER VALUE, NNN .GT. 0, USED TO I 001 

FORM TABLE UNIT MEMBER NAME 
GECOR(XXXNNN). SEE USER PARAMETER 
SCRXXX* 

I OUT OUTPUT* CODE ( FOR TABLE AND/OR I 3 

PRINTED OUTPUT ) 

0 NO PRINT BUT GENERATE TABLE 
GECOR (XXXNNN) 

-1 PRINT OUTPUT IN DB UNITS BUT DO 
NOT GENERATE TABLE GECOR(XXXNNN) 

-2 PRINT OUTPUT IN DIMENSIONLESS 
UNITS BUT DO NOT GENERATE 
TABLE G£COR( XXXNNN) 

-3 BOTH OPTIONS -1 AND -2 

1 PRINT OUTPUT IN DB UNITS AND 
GENERATE TABLE GECOR(XXXNNN) 

2 PRINT OUTPUT IN DIMENSIONLESS 
UNITS AND GENERATE TABLE 
GECOR( XXXNNN) 

3 BOTH OPTIONS 1 AND 2 

I PR I NT PRINTED OUTPUT OPTION CODE I 3 

0 NO PRINT DESIRED 

1 INPUT PRINT ONLY 

2 OUTPUT PRINT ONLY 

3 BOTH INPUT AND OUTPUT PRINT 

lUNITS =2HSI . INPUTS ARE IN SI UNITS A 2HSI 
=7HENGLISH, INPUTS ARE IN ENGLISH 
UNITS 

DATA BASE UNITS AND MEMBERS 

SFIELD(FREQ) SFIELD( THETA ) SFIELD( PHI ) 

( FORMATS ARE DESCRIBED UNDER DATA BASE STRUCTURES ) 

OUTPUT 

USER PARAMETERS 

RS RADIAL DISTANCE FROM SOURCE TO OBSERVER (RS) 

GECERR >0, NO ERRORS OCCURRED 

»1, MEMBER MANAGER ERROR OCCURRED ON OPEN 
»2. INSUFFICIENT LOS AVAILABLE 
^•3. MEMBER MANAGER ERROR OCCURRED ON READ 
»4. AT I EAST ONE USER PARAMETER HAS AN 
INVALID VALUE 
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•5, UNABLE TO BUILD TABLE GECOR(XXXNNN) 

»6. AN INVALID VALUE WAS CALCULATED DURING 
EXECUTION 

SYSTEM PARAMETERS 

NERR SYSTEM ERROR PARAMETER 

.TRUE. ERROR ENCOUNTERED DURING 
EXECUTION (GECERR»1.2,3,5) 
.FALSE. NO ERROR ENCOUNTERED 

DATA BASE UNITS AND MEMBERS 


GECOR(XXXNNN) SEE FORMAT DESCRIPTION UNDER DATA BASE 

STRUCTURES. NOTE MEMBER NAME XXXNNN 
IS FORMED FROM USER PARAMETERS SCRXXX 
AND SCRNNN. OUTPUT OF THIS TABLE IS 
CONTROLLED BY USER PARAMETER lOUT. 


DATA BASE 
SFIELD( 


SFIELD( 

SFIELO( 


STRUCTURES 

FREQ ) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF 1/3 OCTAVE BAND CENTER FREQUENCIES 


THETA) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF POLAR DIRECTIVITY ANGLE IN DEGREES 
PHI ) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF AZIMUTHAL DIRECTIVITY ANGLE IN 
DEG 


GECOR( XXXNNN) - TYPE 1 TABLE OF MEAN SQUARE ACOUSTIC 

PRESSURE DATA AS A FUNCTION OF (1) FREQUENCY, 
(2) DIRECTIVITY ANGLE, AND (3) AZIMUTH ANGLE 


ERRORS 

NON-FATAL 

1. INSUFFICIENT SPACE IN LDS 

2. MEMBER MANAGER ERROR OCCURRED ON SPECIFIED UNIT MEMBER 

3. USER. PARAMETER VALUE OUT OF RANGE - DEFAULT TO BE USED 

REFERENCES 

EMMERLIN6* J.J., CORE ENGINE NOISE CONTROL PROGRAM, VOLUME 
III, SUPPLEMENT I, PREDICTION METHODS. REPORT NO. 
FAA-RD-74-125. III-I, MARCH, 1976. 

MATTA, RAM K., PROPOSED APPENDIX TO ARP876-C0MBUSTI0N NOISE 
JULY ^^197 7* SUBCOMMITTEE, 
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kDS REQUIREMENTS 

LENGTH - NFREQ*NTHETA*NPHI + NTHETA*NPHI + 
NFREQ + NTHETA + NPHI 

WHERE 

NFREQ » NUMBER OF FREQUENCIES 
NTHETA ■ NUMBER OF DIRECTIVITY ANGLES 
NPHI - NUMBER OF AZIMUT" ANGLES 

6DS REQUIREMENTS 

ALLOCATION REQUIRED FOR TABLE GECOR(XXXNNN) 

AND UNIT MEMBERS SFIELD( FREQ, THETA, PHI ) 


4.8.3 Turbine Noise Module (GETUR) 

PURPOSE - „0,S£ AND PURE TONES 

AUTHOR - WK8(L03/00/00) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS 


AE 

NENG 

RS 

STIME 

AREA 


F 

MA 

NBLADE 

D 


MA 

ROTSPD 


TTI 

TSJ 

CA 

RHOA 

SCRXXX 

SCRNNN 

BROAD 

PU^E 


type default 


ENGINE REFERENCE AREA, 

M**2 (FT**2) 

NUMBER OF ENGINES 
D^TANCE FROM SOURCE TO OBSERVER 
SOURCE TIME AT WHICH NOISE IS 
CALCULATED 

“0^5-sectional area 

RE ENGINE REFERENCE AREA 

fuel to air ratio 
absolute humidity 

NUMBER OF ROTOR BLADES 

turbine rotor diameter 
DIMENSIONLESS 

SQRT( ENGINE REFERENCE AREA ) 
AIRCRAFT MACH NUMBER ^ 

ROTATIONAL SPEED 
DIMENSIONLESS 
RE (CA/D) 

ENTRANCE TOTAL TEMPERATURE 

DIMENSIONLESS 

RE AMBIENT TEMPERATURE 

EXIT STATIC TEMPERATURE 

DIMENSIONLESS 

RE AMBIENT TEMPERATURE 

AMBIENT SPEED OF SOUND. 

M/S (FT/S) 

AMBIENT DENSITY 

Il!m ^ letter code XXX USED TO FORM 

table unit member name 

5^Ji|J(X’^XNNN). SEE USER PARAMETER 
otKNNN 

I^NN .GT. 0, USED TO 
FORM TABLE UNIT MEMBER NAME 

^^JUJ(^XXNNN). SEE USER PARAMETER 

SPECTRA broadband 

COMPUTE NOISE DATA FOR PURE 
TONE SPECTRA 


RS 

(SI) 

PI/4 

I 

1 

RS 

SQRT(AE) 

RS 

0.0 

RS 

1.0 

RS 

.0 

RS 

.0 

I 

20 

RS 

1.0 

RS 

0.0 

RS 

.3 

RS 

3.0 

RS 

2.0 

RS 

340.294 

RS 

1.225 

A 

3HXXX 

I 

001 


L 

L 


.TRUE. 

.TRUE. 
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lOUT OUTPUT CODE FOR TABLE AND/OR PRINTED I 3 

OUTPUT 

0 NO PRINT BUT GENERATE TABLE 
GETUR(XXXNNN) 

-1 PRINT OUTPUT IN DB UNITS BUT DO 
NOT GENERATE TABLE GETUR(XXXNNN) 

-2 PRINT OUTPUT IN DIMENSIONLESS 
UNITS BUT DO NOT GENERATE 
TABLE GETUR(XXXNNN) 

-3 BOTH OPTIONS -1 AND -2 

1 PRINT OUTPUT IN DB UNITS AND 
GENERATE TABLE GETUR(XXXNNN) 

2 PRINT OUTPUT IN DIMENSIONLESS 
UNITS AND GENERATE TABLE 
GETIJR(XXXNNN) 

3 BOTH OPTIONS 1 AND 2 

IPRINT OUTPUT PRINT OPTION CODE I 3 

0 NO PRINT DESIRED 

1 PRINT INPUTS ONLY 

2 PRINT OUTPUTS ONLY 

3 BOTH OPTIONS 1 AND 2 

lUNITS «2HSI , INPUTS ARE IN SI UNITS A 2HSI 
=7HENGLISH, INPUTS ARE IN ENGLISH 
UNITS 

DATA BASE UNITS AND MEMBERS 
SFIELD(FREQ) SFIELD(THETA) SFIELD(PHI) 

{ FORMATS ARE DESCRIBED UNDER DATA BASE STRUCTURES ) 

OUTPUT 

IKPP PARAMPTPU<i 

RS DISTANCE FROM SOURCE TO OBSERVER, 

M (FT) 

GETERR »0. NO ERRORS OCCURRED 

=1. MEMBER MANAGER ERROR OCCURRED ON OPEN 
=2, INSUFFICIENT LDS AVAILABLE 
*3, MEMBER MANAGER ERROR OCCURRED ON READ 
=4, AT LEAST ONE USER PARAMETER HAS AN INVALID 
VALUE 

=5. UNABLE TO BUILD TABLE GETUR(XXXNNN) 

»6. AN INVALID VALUE WAS CALCULATED DURING 
EXECUTION 

SYSTEM PARAMETERS 
NERR SYSTEM ERROR PARAMETER 

».TRUE. . ERROR OCCURRED DURING EXECUTION 
(GETERR = 1, 2, 3, 5) 

FALSE., NO ERROR OCCURRED 
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DATA BASE UNITS AND MEMBERS 

GETUR(XXXNNN) SEE FORMAT DESCRIPTIONS UNDER DATA BASE 
STRUCTURES. NOTE MEMBER NAME XXXNNN 
IS FORMED FROM USER PARAMETERS SCRNNN AND 
SCRXXX. OUTPUT OF THIS TABLE IS CONTROLLED 
BY USER PARAMETER lOUT 


DATA BASE STRUCTURES 

SFIELD( FREQ ) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF 1/3 OCTAVE BAND CENTER FREQUENCIES 
IN HZ 

SFIELD( THETA) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF POLAR DIRECTIVITY ANGLE IN DEG 

SFIELD( PHI ) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF AZIMUTHAL DIRECTIVITY ANGLE IN 
DEG 

GETUR(XXXXNNN) - TYPE 1 TABLE OF MEAN SQUARE ACOUSTIC 

PRESSURE DATA AS A FUNCTION OF (1) FREQUENCY. 
(2) DIRECTIVITY ANGLE. AND (3) AZIMUTH ANGLE 


ERRORS 

NON-FATAL 

1. INSUFFICIENT SPACE IN LOS 

2. MEMBER MANAGER ERROR OCCURRED ON SPECIFIED UNIT MEMBER 

3. USER PARAMETER VALUE OUT OF RANGE - DEFAULT TO BE USED 

4. UNABLE TO CALCULATE THE MASS FRACTION OF EACH AIR 
CONSTITUENT 

5. UNABLE TO CALCULATE TOTAL ENTRANCE AND EXIT ENTHALPY 
FATAL - NONE 

LDS REQUIREMENTS 

LENGTH = NFREQ*NTHETA*NPHI + NTHETA*NPHI + 

NFREQ + NTHETA + NPHI 
WHERE 

NFREQ = NUMBER OF FREQUENCIES 
NTHETA = NUMBER OF DIRECTIVITY ANGLES 
NPHI = NUMBER OF AZIMUTH ANGLES 

GDS REQUIREMENTS 

SUFFICIENT ALLOCATION FOR TABLE GETUR( XXXNNN) AND 
UNIT MEMBERS SFIELD( FREQ. THETA. PHI ). 
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4.8.4 Single Stream Circular Jet Noise Module (SGLJETl 


PURPOSE - 


AUTHOR 


PREDICT 1/3 OCTAVE BAND CIRCULAR JET 
NOISE INCORPORATING FORWARD FLIGHT EFFECTS WITH 
METHODS DEVELOPED BY THE SAE A-21 JET NOISE SUB- 
COMMITTEE. 


WKB(L03/00/00) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS 


TYPE DEFAULT 


AJ 


RHOJ 


TJ 


VJ 


RS 


RHOA 

CA 

STIME 


MA 

AE 

NENG 

SCRXXX 


SCRNNN 


lUNITS 


AREA OF FULLY EXPANDED PRIMARY JET 
DIMENSIONLESS UNITS. 

RE ENGINE REFERENCE AREA 
DENSITY OF PRIMARY JET 
DIMENSIONLESS UNITS. 

RE AMBIENT DENSITY 
ABSOLUTE TOTAL TEMPERATURE OF THE 
PRIMARY JET - DIMENSIONLESS UNITS. 

RE AMBIENT TEMPERATURE 
VELOCITY OF PRIMARY JET RELATIVE TO 
NOZZLE EXIT - DIMENSIONLESS UNITS. 

RE AMBIENT SPEED OF SOUND 
RADIAL DISTANCE FROM NOZZLE EXIT TO 
OBSERVER, 

M (FT) 

AMBIENT DENSITY, 

KG/M**3 (SLUGS/FT**3) 

AMBIENT SPEED OF SOUND, 

M/SEC { FT/SEC) 

SOURCE TIME AT WHICH NOISE IS 
CALCULATED 

AIRCRAFT MACH NUMBER 
ENGINE REFERENCE AREA, 

M**2 (FT**2) 

NO. OF ENGINES 

THREE LETTER CODE XXX USED TO FORM 
TABLE UNIT MEMBER NAME 
SGLJET(XXXNNN). SEE USER PARAMETER 
SCRNNN. 

INTEGER VALUE, NNN .GT. 0, USED TO 
FORM TABLE UNIT MEMBER NAME 
SGLJET(XXXNNN). SEE USER PARAMETER 

crpyv V 

=2HSI * , INPUTS ARE SI UNITS 

=7HEN6LISH, INPUTS ARE ENGLISH UNITS 


IN 

RS 

SI UNITS 
1.0 

RS 

1.0 

RS 

1.0 

RS 

1.0 

RS SQRT(AE) 

RS 

1.225 

RS 

340.294 

RS 

0.0 

RS 

RS 

0. 

.7854 

I 

A 

1 

3HXXX 


2HSI 
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I OUT 


IPRINT 


-1 


-3 

1 


OUTPUT CODE FOR TABLE AND 
PRINTED OUTPUT 

0 NO PRINT BUT GENERATE TABLE 
SGLJET(XXXNNN). 

PRINT OUTPUT IN DB UNITS BUT 
DO NOT GENERATE TABLE 
SGLJET(XXXNNN). 

PRINT OUTPUT IN DIMENSIONLESS 
FORM BUT DO NOT GENERATE 
table SGLJET(XXXNNN). 

BOTH OPTIONS -1 AND -2 

PRINT OUTPUT IN OB UNITS AND 

GENERATE TABLE SGLJET(XXXNNN). 

2 PRINT OUTPUT IN DIMENSIONLESS 

FORM AND GENERATE TABLE 
SGLJET(XXXNNN). 

3 BOTH OPTIONS 1 AND 2 

PRINTED OUTPUT OPTION CODE 

0 NO PRINT DESIRED 

1 INPUT PRINT ONLY 

2 OUTPUT PRINT ONLY 

3 BOTH INPUT AND OUTPUT PRINT 
( MEMBER OUTPUT ALWAYS GENERATED 

ACCORDING TO I OUT VALUE ) 


3 


3 


DATA BASE UNITS AND MEMBERS 
( FORMATS ARE DESCRIBED UNDER DATA BASE STRUCTURES ) 


SFIELD( FREQ ) 
SAE( MTH ) 

SAE( PDF ) 


SFIELD( PHI ) 
SAE( NDF ) 
SAE( SCF ) 


SFIELD( THETA ) 
SAE( OM ) 

SAE( SJC ) 


OUTPUT 

USER PARAMETERS 

RS RADIAL DISTANCE FROM NOZZLE EXIT TO OBSERVER 


DATA BASE UNITS AND MEMBERS 


SGLJET( XXXNNN ) SEE FORMAT UNDER DATA BASE STRUCTURES 

NOTE member name XXXNNN IS FORMED FROM 
SRCXXX AND SRCNNN. 
OUTPUT OF THIS UNIT MEMBER TABLE IS 

SrSTEH PARAMETERS ‘““T. 

NERR system ERROR PARAMETER 

.TRUE, ERROR ENCOUNTERED DURING MODULE 
EXECUTION 


.FALSE. NO ERROR ENCOUNTERED 
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DATA BASE STRUCTURES 

SFIELD( FREQ ) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF 1/3 OCTAVE BAND CENTER FREQUENCIES IN 
HZ 

SFIELD( PHI ) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 

VALUES OF AZIMUTHAL DIRECTIVITY 
ANGLE IN DEG 

SFIELD(THETA) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF POLAR DIRECTIVITY 
ANGLE IN DEG 


TABLES 

UNIT(TABLE) TYPE 

SAE(OM) 1 

SAE(PDF) 1 

SAE(NDF) 1 

SAE(MTH) 1 

SAE(SJC) 1 


SAE(SCF) 1 


SGLJET(XXXNNN) 1 


DESCRIPTION 

JET VARIABLE DENSITY EXPONENT AS 
FUNCTION OF LOGIO OF RATIO OF 
JET VELOCITY TO SPEED OF SOUND 
LOGIO OF POWER DEVIATION FACTOR 
FROM V**8 LAW AS 

FUNCTION OF LOGIO OF RATIO OF JET 
VELOCITY TO SPEED OF SOUND 
LOGIO OF NORMALIZED DIRECTIVITY 
FUNCTION FOR CIRCULAR JETS AS 
FUNCTION OF (1) DIR. ANGLE IN DEG 
AND (2) LOGIO OF RATIO OF JET VELO- 
CITY TO SPEED OF SOUND 
FORWARD VELOCITY INDEX AS A FUNCTION 
OF DIRECTIVITY ANGLE IN DEG 
NORMALIZED SPECTRAL DISTRIBUTION 
FACTOR AS FUNCTION OF 
(1) LOGIO OF CORRECTED STROUHAL 
NUMBER, (2) RATIO OF JET 
VELOCITY TO SPEED OF SOUND. AND 
(3) DIRECTIVITY ANGLE FROM JET INLET 
IN DEG, (4) RATIO OF JET TEMPERA- 
TURE TO AMBIENT TEMPERATURE 
STROUHAL NUMBER CORRECTION FACTOR 
AS FUNCTION OF RATIO OF JET VELOCITY 
TO SPEED OF SOUND AND DIRECTIVITY 
ANGLE 

MEAN SQUARE ACOUSTIC PRESSURE AS A 
FUNCTION OF (1) FREQUENCY, (2) 
DIRECTIVITY ANGLE AND (3) AZIMUTH 
ANGLE 


ERRORS 

NON-FATAL 

1. INSUFFICIENT SPACE IN LDS 

2. MEMBER MANAGER ERROR OCCURRED ON SPECIFIED UNIT MEMBER 
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3. INTERPOLATION REQUEST NOT COMPLETE 

4. USER PARAMETER VALUE OUT OF RANGE - DEFAULT TO BE USED 

5. USER PARAMETER MA MAY NOT BE GREATER THAN USER 
PARAMETER VJ 

FATAL - NONE 

LOS REQUIREMENTS 

LENGTH = NFREQ*NTHETA*NPHI + NTHETA*NPHI + 

NFREQ + NTHETA + NPHI 

WHERE 

NFREQ « NUMBER OF FREQUENCIES 
NTHETA » NUMBER OF DIRECTIVITY ANGLES 
NPHI = NUMBER OF AZIMUTH ANGLES 

GDS REQUIREMENTS 

ALLOCATION REQUIRED FOR TABLES SAE(OM), SAE(PDF), 

SAE(NOF). SAE(MTH), SAE(SCJ), SAE(SCF), 

AND SGLJET(XXXNNN) AND FOR UNIT MEMBERS 
SFIELD( FREQ, THETA, AND PHI ). 


4-65 


> ■ 









4.8,5 Circular Jet Shock Cell Noise Module (SAESHK) 


PURPOSE - PREDICT THE BROADBAND SHOCK ASSOCIATED NOISE FROM A 
SINGLE CONVERGENT NOZZLE OPERATING AT 
SUPERCRITICAL PRESSURE RATIOS. 

AUTHOR - WKB(L03/00/00) 

MMF(L03/00/09) 

INPUT 


USER PARAMETERS TYPE DEFAULT 


AE 

ENGINE REFERENCE AREA* 

RS 

SI VAL. 
PI/4 

NENG 

M**2 (FT**2) 
NUMBER OF ENGINES 

I 

1 

NSHK 

NUMBER OF SHOCKS 

I 

8 

DELTA 

ANGLE BETWEEN FLIGHT VECTOR AND 

RS 

0.0 

RS 

ENGINE INLET AXIS IN DEG. 

THIS IS THE ENGINE 
INCLINATION ANGLE + ANGLE OF 
ATTACK. 

DISTANCE F:,0M NOZZLE EXIT TO A 

RS 

SQRT(AE) 

AJ 

PSEUDO OBSERVER, 
M (FT) 

AREA OF THE JET 

RS 

1.0 

MA 

DIMENSIONLESS UNITS. 

(RE ENGINE REFERENCE AREA) 
AIRCRAFT MACH NUMBER 

RS 

0.0 

MJ 

FULLY EXPANDED JET MACH NUMBER 

RS 

1.414 

TJ 

JET TOTAL TEMPERATURE 

RS 

1.0 

VJ 

DIMENSIONLESS UNITS. 

(RE AMBIENT TEMPERATURE) 
FULLY EXPANDED JET VELOCITY 

RS 

1.0 

CA 

DIMENSIONLESS UNITS. 

(RE AMBIENT SPEED OF SOUND) 
AMBIENT SPEED OF SOUND. 

RS 

340.294 

RHOA 

M/S (FT/S) 
AMBIENT DENSITY. 

RS 

1.225 

STIME 

KG/M**3 (LB/FT**3) 

SOURCE TIME AT WHICH NOISE IS 

RS 

0.0 

ICA078 

CALCULATED 

IF .TRUE.. CALCULATE SHOCK NOISE 

L 

.FALSE. 


FOR THE ICAO REFERENCE PROCEDURE 
(1978) WHICH IS BASED ON SAE ARP 
876. THE ONLY DIFFERENCE IS F3R 
ICA078=.TRUE., AN ADDITIONAL 
DIRECTIVITY FUNCTION IS APPLIED 
TO THE NOISE DATA. 
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1 


3t 


IPRINT 


I OUT 


lUNITS 


SCRXXX 


SCRNNN 


PRINT FLAG i 

0 NO PRINT DESIRED 

1 INPUT PRINT ONLY 

2 OUTPUT PRINT ONLY 

3 BOTH INPUT AND OUTPUT PRINT 

TABLE OUTPUT AND PRINT OUTPUT OPTION I 
0 NO PRINT BUT GENERATE TABLE 

SAESHK(XXXNNN) 

-1 PRINT OUTPUT IN DB UNITS BUT DO 
NOT GENERATE TABLE SAESHK(XXXNNN) 
-2 PRINT OUTPUT IN DIMENSIONLESS FORM 
BUT DO NOT GENERATE TABLE 
SAESHK(XXXNNN) 

-3 BOTH OPTIONS -1 AND -2 

1 PRINT OUTPUT IN DB UNITS AND 
GENERATE TABLE SAESHK(XXXNNN) 

2 PRINT OUTPUT IN DIMENSIONLESS FORM 

AND GENERATE TABLE SAESHK(XXXNNN) 

3 BOTH OPTIONS 1 AND 2 

=2HSI , INPUTS ARE IN SI UNITS A 
=7HENGLISH. INPUTS ARE IN ENGLISH 
UNITS 

THREE LETTER CODE XXX USED TO FORM A 
TABLE UNIT MEMBER NAME 
SAESHK(XXXNNN). SEE USER PARAMETER 
SCRNNN 

INTEGER VALUE, NNN .GT. 0, USED TO I 
FORM TABLE UNIT MEMBER 
SAESHK(XXXNNN). SEE USER PARAMETER 
SCRXXX 


3 


3 


2HSI 


3HXXX 


001 


DATA BASE UNITS AND MEMBERS 
( FORMATS ARE DESCRIBED UNDER DATA BASE STRUCTURE^ 
SFIELD(FREQ) SFIELD(THETA) SFIELD(PHI) 


) 


OUTPUT 

USER PARAMETERS 


RS 
SAEERR 


DISTANCE FROM NOZZLE EXIT TO OBSERVER 
*0. NO ERRORS OCCURRED 
*1, MEMBER MANAGER ERROR OCCURRED ON OPEN 
»2, INSUFFICIENT LDS AVAILABLE 
»3, MEMBER MANAGER ERROR OCCURRED ON READ 
=4, AT LEAST ONE USER PARAMETER HAS 
AN INVALID VALUE 

=5, UNABLE TO BUILD OUTPUT TABLE 
SAESHK(XXXNNN) 

»6, AN INVALID VALUE WAS CALCULATED 
DURING EXECUTION 


4-67 







_C1rcu]ar Jet Shock Cell Noise Module ^SAF SHK ] 


SYSTEM PARAMETERS 

NERR .TRUE., IMPLIES ERROR ENCOUNTERED DURING MODULE 

EXECUTION ( SAEERR-1,2,3,5 ) 

.FALSE., NO ERRORS ENCOUNTERED 

DATA BASE UNIT MEMBERS 

SAESHK(XXXNNN) SEE FORMAT UNDER DATA BASE STRUCTURES. 

NOTE MEMBER NAME XXXNNN IS FORMED FROM 
USER PARAMETERS SCRXXX AND SCRNNN. 
OUTPUT OF THIS TABLE IS CONTROLLED 
BY USER PARAMETER lOUT. 

DATA BASE STRUCTURES 

SFIELD( FREQ ) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF 1/3 OCTAVE BAND CENTER 

, frequencies in HZ 

SFIELD( THETA ) -1 RECORD MEMBER IN *RS FORMAT CONTAINING 

VALUES OF THE POLAR DIRECTIVITY ANGLE IN 
DEG 

SFIELO( PHI ) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 

VALUES OF AZIMUTHAL DIRECTIVITY ANGLE IN 
DEG 

SAESHK( XXXNNN) - TYPE 1 TABLE CONTAINING MEAN SQUARE ACOUSTIC 
PRESSURE AS A FUNCTION OF (1) FREQUENCY, 

(2) DIRECTIVITY ANGLE, AND (3) AZIMUTH 
ANGLE 


ERRORS 

NON-FATAL 

1. INSUFFICIENT LDS SPACE. 

OCCURRED ON SPECIFIED UNIT MEMBER. 
3. USER PARAMETER VALUE OUT OF RANGE - DEFAULT TO BE USED. 

REMARKS 

REFERENCES 

TANNA,H.K., PREDICTION METHOD FOR SHOCK ASSOCIATED NOISE 

NOZZLES AT SUPERCRITICAL CONDITIONS, 
PROPOSAL TO SAE-A21 COMMITTEE, JULY 1977. 
HARPER-BOURNE, M. , AND FISHER, M. J., THE NOISE FROM SHOCK 
WAVES IN SUPERSONIC JETS, AGARD REPORT, CP-131, 

1 ^ r J • 

TANNA, H. K., DEAN, P. 0., AND BURRIN, R. H. , THE 

RADIATION OF SUPERSONIC JET NOISE, VOL 
4 - SHOCK ASSOCIATED NOISE DATA, AIR FORCE AERO- 
PROPULSION LABORATORY TECHNICAL REPORT, AFAPL-TR- 
76-65, 1976, 
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RANGE OF APPLICATION 

m^OBSE^R'AN^r SHOULD BE RESTRIcfES“w"?Hf 

D«s aUS ?SISe^"shJ 2^ Ssr^oKf car be 
LDS REQUIREMENTS 

LEHGTH . HFRE^NTHETA.j,p„, » NTHETA-NRHI . 

WHERE 

wt2cta * Jumber of frequencies 

“ number of directivity ANGLF^ 

NPHI s number of azimuth ANGLES 

60S requiremfnts 
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4.8.6 Stone Jet Noise Module (STNJET) 


PURPOSE - PREDICT THE FAR-FIELD MEAN SQUARE ACOUSTIC PRESSURE 
FOR SINGLE STREAM AND COAXIAL CIRCULAR JETS BY THE 
STONE METHOD 

AUTHOR - CBF(L03/00/04) 

MMF(L03/00/09) 


INPUT DEFAULT 

USER PARAMETERS SI UNITS 

CA AMBIENT SPEED OF SOUND (RS). M/S 340.294 

(FT/S) 

RHOA AMBIENT DENSITY (RS), KG/M**3 1.225 

(SLUG/FT**3) 

MA AIRCRAFT MACH NUMBER (RS) 0. 

RS DISTANCE FROM NOZZLE EXIT TO PSEUDO- SQRT 

OBSERVER (RS), M (FT) (PI/4.) 

AE ENGINE REFERENCE AREA (RS), M**2 PI/4. 

(FT**2) 

A1 PRIMARY FULLY EXPANDED JET AREA (RS), 1. 

RE AE 

DEI ACTUAL PRIMARY STREAM EQUIVALENT 2/ 

DIAMETER (RS), RE SQRT(AE) SQRT(PI) 

OHl ACTUAL PRIMARY STREAM HYDRAULIC 2/ 

DIAMETER (RS), RE SQRT(AE) SQRT(PI) 


VI PRIMARY STREAM JET VELOCITY (RS), RE CA 1. 


RHOl PRIMARY STREAM JET DENSITY (RS), RE RHOA 1. 

T1 PRIMARY STREAM TOTAL TEMPERATURE (RS), 1. 

RE TA 

Ml PRIMARY STREAM MACH NUMBER (RS) 1. 

A2 SECONDARY FULLY EXPANDED JET AREA (RS), 0. 

RE AE 

V2 SECONDARY STREAM JET VELOCITY (RS), 0. 

RE CA 

RH02 SECONDARY STREAM JET DENSITY (RS), 1. 

RE RHOA 

T2 SECONDARY STREAM TOTAL TEMPERATURE (RS), 1. 

RE TA 

M2 SECONDARY STREAM MACH NUMBER (RS) 0. 

STIME SOURCE TIME (RS), SEC 0. 

NENG NUMBER OF ENGINES (I) 1 

SCRNNN INTEGER VALUE, NNN, .GT. 0 USED TO 1 

FORM TABLE UNIT MEMBER NAME 
STNJET(XXXNNN) 

SCRXXX THREE LETTER CODE, XXX, USED TO 3HXXX 

FORM TABLE UNIT MEMBER NAME 
STNJET(XXXNNN) 

lUNITS INPUT UNITS FLAG (I) 2HSI 

7HEN6LISH, ENGLISH UNITS 
2HSI, SI UNITS 
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PLUG .TRUE., IMPLIES NOZZLE WITH CONICAL .FALSE 

PLUG 

.FALSE., IMPLIES NOZZLE WITHOUT PLUG 
CIRCLE .TRUE., IMPLIES CIRCULAR NOZZLE .FALSE 

.FALSE., IMPLIES COAXIAL NOZZLE 
SUPER .TRUE., IMPLIES SUPERSONIC CIRCULAR .FALSE 

NOZZLE OR SUPERSONIC PRIMARY JET 
OF A COAXIAL NOZZLE 
.FALSE., IMPLIES SUBSONIC CIRCULAR 

NOZZLE OR SUBSONIC PRIMARY AND 
SECONDARY JETS OF A COAXIAL NOZZLE 
lOUT TABLE OUTPUT AND PRINT OUTPUT OPTION (I) 3 

0, NO PRINT, BUT GENERATE TABLE 
STNJET(XXXNNN) 

-1, PRINT OUTPUT IN DB UNITS, BUT DO NOT 
GENERATE TABLE STNJET(XXXNNN) 

-2, PRINT OUTPUT IN DIMENSIONLESS FORM, 

BUT DO NOT GENERATE TABLE 
STNJET(XXXNNN) 

-3, BOTH OPTIONS -1 AND -2 

1, PRINT OUTPUT IN DB UNITS AND GENERATE 
TABLE STNJET(XXXNNN) 

2, PRINT OUTPUT IN DIMENSIONLESS FORM 
AND GENERATE TABLE STNJET(XXXNNN) 

3, BOTH OPTIONS 1 AND 2 

IPRINT PRINT OPTION CODE (I) 3 

0 NO PRINT DESIRED 

1 INPUT PRINT ONLY 

2 OUTPUT PRINT ONLY 

3 BOTH INPUT AND OUTPUT PRINT 

DATA BASE UNIT MEMBERS 

(DESCRIBED UNDER DATA BASE STRUCTURES) 

SFIELD( FREQ ) 

SFIELO( THETA ) 

SFIELDf PHI ) 
stntblI SDF ) 

STNTBLI JDF ) 

STNTBL( FSP ) 

OUTPUT 

USER PARAMETERS 

RS DISTANCE FROM NOZZLE EXIT TO PSUEDO-OBSERVER 
SYSTEM PARAMETER 

NERR .TRUE. - IMPLIES AN ERROR WAS ENCOUNTERED 

DURING MODULE EXECUTION 
.FALSE. - NO ERROR ENCOUNTERED 


stone Jet Noise Module (STNJET) 


DATA BASE UNIT MEMBERS 

STNJET(XXXNNN) SEE FORMAT UNDER DATA BASE STRUCTURES. 

NOTE MEMBER NAM^ XXXNNN IS FORMED FROM 
USER PARAMETERS SCRXXX AND SCRNNN. 
OUTPUT OF THIS TABLE IS CONTROLLED BY 
USER PARAMETER lOUT. 


DATA BASE STRUCTURES 

SFIELD( FREQ ) ) RECORD MEMBER IN ^RS FORMAT CONTAINING 

VALUES OF 1/3 OCTAVE BAND CENTER FREQUENCIES 
IN HZ 

SFIELD( PHI ) 1 RECORD MEMBER IN *RS FORMAT CONTAINING 

VALUES OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEG 

SFIELD(THETA) 1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF POLAR DIRECTIVITY ANGLE 
IN DEG 


STNJET(XXXNNN) 


STNTBL(JDF) 


STNTBL(SDF) 


STNTBL(FSP) 


TYPE 1 TABLE CONTAINING MEAN 
SQUARE PRESSURE AS A FUNCTION OF 
(1) FREQUENCY. (2) DIRECTIVITY ANGLE. 

AND (3) AZIMUTHAL ANGLE 

TYPE 1 TABLE CONTAINING THE JET MIXING 

NOISE SPECTRAL DISTRIBUTION FACTOR AS A 

FUNCTION OF LOGIO OF THE STROUHAL NUMBER AND 

THE MODIFIED DIRECTIVITY ANGLE 

TYPE 1 TABLE CONTAINING SHOCK NOISE SPECTRAL 

DISTRIBUTION FACTOR AS A FUNCTION OF LOGIO 

OF THE SHOCK NOISE FREQUENCY PARAMETER 

TYPE 1 TABLE CONTAINING THE FREQUENCY SHIFT 

PARAMETER AS A FUNCTION OF THE LOG OF THE 

AREA RATIO PARAMETER AND OF THE VELOCITY 

RATIO 


ERRORS 
NON- FATAL 

1. INSUFFICIENT LOCAL DYNAMIC STORAGE. 

2. MEMBER MANAGER ERROR OCCURRED ON SPECIFIED UNIT MEMBER. 

3. SHOCK CELL NOISE CANNOT BE COMPUTED WITH PRIMARY STREAM 
MACH NUMBER .LE. ONE. 

4. COAXIAL JET NOISE CANNOT BE COMPUTED WHEN SECONDARY JET 
VELOCITY IS GREATER THAN PRIMARY JET VELOCITY. 

5. INTERPOLATION ERROR ENCOUNTERED BY SUBPROGRAM TMTERP. 

6. USER Parameter value out of range, default value will 
BE used. 

fatal - NONE 
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stone Jet Noise Module (STNJET) 


REMARKS 

REFERENCES'^ J.R.: "INTERIM PREDICTION METHOD FOR JET 

NOISE". NASA TM X-71618, 1974. 

2. STONE. J.R., AND MONTEGANI, F.J.: "AN IMPROVED 

PREDICTION METHOD FOR THE NOISE GENERATED 
IN FLIGHT BY CIRCULAR JETS". NASA TM-81470, 
APRIL. 1980. 


LDS REQUIREMENTS 

LENGTH => ( NFREQ * NTHETA * NPHI 
NFREQ + NTHETA + NPHI 


) + ( NTHETA 


NPHI ) + 


GDS REQUIREMENTS 

SUFFICIENT ALLOCATION 
STNJET(XXXNNN) 
STNTBL(JDF) 
STNTBL(SDF) 
STNTBL(FSP) 


FOR THE FOLLOWING TABLES 
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4.8.7 Qua] Stream Coannular Jet Noise Module (CNLJET) 


PURPOSE - CNLJET PREDICTS THE NOISE CHARACTERISTICS OF A 
COANNULAR JET EXHAUST NOZZLE WITH AN INVERTED 
VELOCITY PROFILE 

AUTHOR - WKB(L03/00/00) 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS TYPE DEFAULT 

(SI) 


AE 

ENGINE REFERENCE AREA, 
M**2 (FT**2) 

RS 

PI/4 

NENG 

NUMBER OF ENGINES 

I 

1 

RS 

DISTANCE FROM NOZZLE EXIT TO 
OBSERVER, 

M (FT) 

RS SQRT(AE) 

A1 

PRIMARY JET AREA 
DIMENSIONLESS 
RE AE 

RS 

1.0 

T1 

PRIMARY JET TOTAL TEMPERATURE 

DIMENSIONLESS 

RE AMBIENT TEMPERATURE 

RS 

1.0 

VI 

PRIMARY JET VELOCITY 
DIMENSIONLESS 
RE CA 

RS 

1.0 

RHOl 

PRIMARY JET DENSITY 
DIMENSIONLESS 
RE RHOA 

RS 

1.0 

GAMMAl 

RATIO OF SPECIFIC HEATS FOR 
PRIMARY JET 

RS 

1.4 

A2 

SECONDARY JET AREA 
DIMENSIONLESS 
RE AE 

RS 

,0 

DH2 

SECONDARY JET HYDRAULIC DIAMETER 

DIMENSIONLESS 

RE SQRT( AE ) 

RS 

1.0 

T2 

SECONDARY JET TOTAL TEMPERATURE 

dimensionless 

RE AMBIENT TEMPERATURE 

RS 

1.0 

V2 

SECONDARY JET VELOCITY 
DIMENSIONLESS 
RE CA 

RS 

.0 

RH02 

SECONDARY JET DENSITY 
DIMENSIONLESS 
RE RHOA 

RS 

1.0 

GAMMA2 

RATIO OF SPECIFIC HEATS FOR 
SECONDARY JET 

RS 

1.4 

CA 

AMBIENT SPEED OF SOUND, 
M/S (FT/S) 

RS 

340.294 




4-74 


UuaLjjtreain Codji njilar Jet Noise Mod.iU 


MA 

STIML 

KHOA 

SCRXXX 


SCRNNN 


I OUT 


IRRINr 


UNITS 


IS 


AIRCRAFT MACH NUMHKR 
SpCK riMt AT WHICH NOISE 
CALCULATED 
ambient DENSITY, 

KU/M**3 (SLUG/FT**3) 

Sr TO FORM 

TABLE UNIT MEMBER NAME 

parameter 

poIm 

FORM TABLE UNIT MEMBER NAME 

Sxxx^^^^*^*^*'* * parameter 

Inu^u} 

0 NO PRINT BUT GENERATE TABLE 
CNLJET(XXXNNN) 

f|[!J'^^,^>^UTPUT IN DR UNITS BUT DO 
NOT GENERATE TABLE CNLJETf XXXNNNI 
PJINT OUTPUT IN DIMENSIONLESS ^ 

UNITS BUT DO NOT GENERATE 
TABLE CNLJET(XXXNNN) 

BOTH OPTIONS -1 AND -2 
PRINT OUTPUT IN DB UNITS AND 
GENERATE TABLE CNLJETIXXXNNNI 
PRINT OUTPUT IN DIMEN^MESS 
UNITS AND GENERATE TABLE 
CNLUET(XXXNNN) 

»OTH OPTIONS 1 AND 2 
PRINT OPTION CODE , 

0 NO PRINT DESIRED 

1 PRINT INPUTS ONLY 

2 PRINT OUTPUTS ONLY 

3 BOTH OPTIONS 1 AND 2 

=2HSI INPUTS ARE IN SI UNITS A 


RS 

RS 


-I 

-2 


-3 

1 


3 


* V' I o 

=/HENGLlSH, INPUTS ARE 

DATA BASE UNITS AND MEMBERS 
5FIE)D(FREg) SFIELD(THETA) 

JWRCOAN(OM) JWRCOAN(PDF) ^ 

JWRCOAN(S2) JWRCOAN(NSF) 

JWRCOAN( ALPHA) JWRCOAN(DIR) 

( FORMAT'? AUP nircrD t UL* I 


( korhats OATA 


IN ENGLISH 


SFIELD(PHI) 

JWRCOAN(Sl) 

JWRCOAN(CBF) 

3WRCOAN(MTH) 

Acr crmir»Tiii\t 


.0 

.0 


KS 1.22S 
A 3HXXX 


DO I 


2KSI 
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Dual Stream Coannular Jet Noise Module (CNLJET) 


OUTPUT 

USER PARAMETERS 

RS DISTANCE FROM SOURCE TO OBSERVER, 

M (FT) 

CNLERR =0. NO ERRORS OCCURRED 

»1, MEMBER MANAGER ERROR OCCURRED ON OPEN 
=2, INSUFFICIENT IDS AVAILABLE 
=3, MEMBER MANAGER ERROR OCCURRED ON READ 
=4. AT LEAST ONE USER PARAMETER HAS AN INVALID 
VALUE 

=5, UNABLE TO BUILD TABLE CNLJET(XXXNNN) 

=6. AN INVALID VALUE WAS CALCULATED DURING 
EXECUTION 

SYSTEM PARAMETERS 
NERR SYSTEM ERROR PARAMETER 

».TRUE. , ERROR OCCURRED DURING EXECUTION 
(CNLERR « 1, 2, 3, 5) 

«. FALSE., NO ERROR OCCURRED 

DATA BASE UNITS AND MEMBERS 

CNLJET(XXXNNN) SEE FORMAT DESCRIPTIONS UNDER DATA BASE 
STRUCTURES, NOTE MEMBER NAME XXXNNN 
IS FORMED FROM USER PARAMETERS SCRNNN AND 
SCRXXX. OUTPUT OF THIS TABLE IS CONTROLLED 
BY USER PARAMETER lOUT 


DATA BASE STRUCTURES 


JWRCOAN(OM) 


JWRCOAN(PDF) 


JWRCOAN(Sl) 


JWRC0AN(S2) 


TYPE 1 TABLE OF JET VARIABLE DENSITY 
EXPONENT AS A FUNCTION OF LOGIO OF THE 
OF RATIO OF JET VELOCITY TO THE SPEED 
OF SOUND 

TYPE 1 TABLE OF LOOlO OF POWER 
DEVIATION FACTOR OF SAE METHOD FROM 
V**8 LAW AS A FUNCTION OF LOGIO OF 
RATIO OF JET VELOCITY TO THE SPEED 
OF SOUND 

TYPE 1 TABLE OF LOGIO OF PEAK 
STROUHAL NUMBER FOR FIRST COMPONENT 
OF SPECTRUM AS A FUNCTION OF (1) 
DIRECTIVITY ANGLE IN DEGREES AND (2) 
LOGIO OF THE RATIO OF THE JET VELOCITY 
TO THE SPEED OF SOUND 
TYPE 1 TABLE OF PEAK STROUHAL NUMBER 
FOR THE SECOND COMPONENT OF SPECTRUM 
AS A FUNCTION OF (1) DIRECTIVITY 
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Dual Stream Coannular Jet Noise Module (CNLJET) 


JWRCOAN(NSF) 

JWRCOAN(ALPHA) 


JWRCOAN(CBF) 

JWRCOAN(DIR) 

JWRCOAN(MTH) 

SFIELO(FREQ) 

SFIELD(THETA) 

SFIELD(PHI) 

CNLJET(XXXNNN) 


ANGLE IN DEGREES, (2) LOGIO OF 
THE RATIO OF THE JET VELOCITY TO THE 
SPEED OF SOUND 

TYPE 1 TABLE OF LOGIO OF NORMALIZED 
SPECTRUM FUNCTION AS A FUNCTION OF (1) 
LOGIO OF THE STROUHAL NUMBER AND (2) 
DIRECTIVITY ANGLE IN DEG 
TYPE 1 TABLE OF LOGIO OF RATIO OF PEAK 
STROUHAL NUMBER FOR SECOND COMPONENT 
TO THAT OF FIRST COMPONENT AS A 
FUNCTION OF (1) VELOCITY RATIO 
V2/V1, (2) LOGIO OF THE RATIO OF THE 
JET VELOCITY TO THE SPEED OF SOUND, AND 
(3) DIRECTIVITY ANGLE IN DEG 
TYPE 1 TABLE OF OVERALL POWER LEVEL 
BENEFIT FOR COANNULAR NOZZLE IN DB AS 
A FUNCTION OF (1) THE VELOCITY RATIO 
V2/V1 AND (2) LOGIO OF THE RATIO OF 
JET VELOCITY TO THE SPEED OF SOUND 
TYPE 1 TABLE OF 10*L0G10 OF NORMALIZED 
DIRECTIVITY FUNCTION FOR COANNULAR JETS AS 
A FUNCTION OF (1) DIRECTIVITY ANGLE IN 
DEGREES AND (2) LOGIO OF THE RATIO OF 
THE JET VELOCITY TO THE SPEED OF SOUND 
TYPE 1 TABLE OF FORWARD FLIGHT EFFECT 
CORRECTION (JET VELOCITY EXPONENT) AS 
A FUNCTION OF DIRECTIVITY ANGLE IN 
DEG 

1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF 1/3 OCTAVE BAND CENTER 
FREQUENCIES IN HZ 

1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF POLAR DIRECTIVITY ANGLE IN 
DEG 

1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEG 

TYPE 1 TABLE OF MEAN SQUARE ACOUSTIC 
PRESSURE DATA AS A FUNCTION OF (1) 
FREQUENCY, (2) DIRECTIVITY ANGLE, AND (3) 
AZIMUTH ANGLE 
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stream Coannular Jet Noise Module (CNLJET] 


ERRORS 

NON-FATAL 

1. INSUFFICIENT SPACE IN IDS 

2. MEMBER MANAGER ERROR OCCURRED ON SPECIFIED UNIT MEMBER 

3. USER PARAMETER VALUE OUT OF RANGE - DEFAULT TO BE USED 



4. UNABLE TO INTERPOLATE SPECIFIED TABLE 

5. SECONDARY JET VELOCITY IS LESS THAN THE PRIMARY 


JET VELOCITY 



I 

} 


4.8.8 Airframe Noise Module (FNKAFM) 


TO PREDICT THE BROADBAND NOISE FOR THE DOMINANT 
COMPONENTS OF THE AIRFRAME BY THE FINK METHOD 
REFERENCE - FEDERAL AVIATION ADMINISTRATION REPORT 
NO. FAA-RD-77-28. MARCH 1977, AIRFRAME NOISE 
PREDICTION METHOD, M. R. FINK 


AUTHOR - CBF(L03/00/00) 
MMF(L03/00/09) 

INPUT 

USER PARAMETERS 


AF 

AH 

AV 

AM 

BF 

BH 

BV 

BW 

DELTAF 

DMG 


MA 

ST I ME 

NWMG 

NWNG 

NMG 

NNG 

NS 

IPRINT 


FLAP AREA (RS), M**2 { FT ** 2 ) 

HORIZONTAL TAIL AREA (RS) , M**2 ( FT ** 2 ) 
VERTICAL TAIL AREA (RS), M**2 ( FT ** 2 ) 
WING AREA (RS), M**2 ( FT ** 2 ) 

FLAP SPAN (RS), M (FT) 

HORIZONTAL TAIL SPAN (RS), M (FT) 

VERTICAL TAIL SPAN (RS), M (FT) 

MING SPAN (RS), M (FT) 

FLAP SETTING (RS), DEG 

TIRE DIAMETER OF MAIN LANDING GEAR (RS), 

M (FT) 

TIRE DIAMETER OF NOSE LANDING GEAR (RS), 

M (FT) 

MAIN LANDING GEAR STRUT LENGTH (RS), M (FT) 
NOSE LANDING GEAR STRUT LENGTH (RS), M (FT) 
AMBIENT SPEED OF SOUND (RS), M/S (FT/S) ' 
AMBIENT DENSITY (RS), KG/M**3 
(SLUG/FT ** 3) 

AMBIENT DYNAMIC VISCOSITY (RS), 

KG/(M S) (SLUG/ (FT S) ) ' 

DISTANCE FROM SOURCE TO OBSERVER (RS), 

M (FT) 

AIRCRAFT MACH NUMBER (RS) 

SOURCE TIME (RS) 

NUMBER OF WHEELS PER MAIN LANDING GEAR (I) 
NUMBER OF WHEELS PER NOSE LANDING GEAR (I) 
NUMBER OF MAIN LANDING GEAR (I) 

NUMBER OF NOSE LANDING GEAR (I) 

NUMBER OF SLOTS FOR TRAILING EuGE FLAPS (I) 
PRINTED OUTPUT CODE (I) 

=0, NO PRINT 

»1, INPUT PRINT ONLY 

»2, OUTPUT PRINT ONLY 

=3, BOTH INPUT AND OUTPUT PRINT 
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Airframe Noise Module (FNKAFM) 


I OUT 


SCRNNN - 
DYNCLN - 

OELTAW - 

LAN06 - 

SCRXXX - 
lUNlTS - 


TABLE AND PRINT OUTPUT OPTION (I) 3 

» 0. NO PRINT BUT GENERATE TABLE 
FNKAFM(XXXNNN) 

»-l, PRINT OUTPUT IN DB UNITS. BUT DO NOT 
GENERATE TABLE FNKAFM(XXXNNN) 

=-2, PRINT OUTPUT IN DIMENSIONLESS FORM. BUT 
DO NOT GENERATE TABLE FNKAFM(XXXNNN) 

=■-3. BOTH OPTIONS -1 AND -2 
=■ 1. PRINT OUTPUT IN DB UNITS AND GENERATE 
TABLE FNKAFM(XXXNNN) 

= 2. PRINT OUTPUT IN DIMENSIONLESS FORM AND 
GENERATE TABLE FNKAFM(XXXNNN) 

= 3. BOTH OPTIONS 1 AND 2 

INTEGER VALUE. NNN .6T. 0 USED TO FORM 001 

TABLE UNIT MEMBER FNKAFM(XXXNNN) 

DESCRIPTION OF AIRCRAFT F 

.TRUE.. AEROOYNAMICALLY CLEAN AIRCRAFT 
.FALSE.. NON-AERODYNAMICALLY CLEAN AIRCRAFT 
TYPE OF WING PLAN FORM 
.TRUE.. DELTA-WINGED AIRCRAFT 
.FALSE.. RECTANGULAR-WINGED AIRCRAFT 
LANDING GEAR POSITION 
4HD0WN. INDICATES LANDING GEAR IS DOWN 
4HUP . INDICATES LANDING GEAR IS UP 
THREE LETTER CODE XXX USED TO FORM 
TABLE UNIT MEMBER NAME FNKAFM(XXXNNN) 

INPUT UNITS FLAG 
=2HSI. SI UNITS 
»7HENGL1SH. ENGLISH UNITS 


4HD0WN 

i 

\ 

I 

3HXXX I 

2HSI j 


{ THE NEXT SEVEN CODES HAVE THE FOLLOWING VALUES ) 

( .FALSE.. DO NOT INCLUDE IN NOISE PREDICTION ) i 

( .TRUE.. INCLUDE IN TOTAL PREDICTION ) 

TEWN - TRAILING EDGE WING NOISE T ^ 

TEHTN - TRAILING EDGE HORIZONTAL TAIL NOISE T 1 

TEVTN - TRAILING EDGE VERTICAL TAIL NOISE T ' 

TEFN - TRAILING EDGE FLAP NOISE F 

LESN - LEADING EDGE SLAT NOISE F i 

MLGN - MAIN LANDING GEAR NOISE T 

NLGN - NOSE LANDING GEAR NOISE T 

DATA BASE UNIT MEMBERS 1 

(DESCRIBED UNDER DATA BASE STRUCTURES) 1 

SFIELO(FREQ) i 

SFIELD THETA) 

SFIELD(PHI) ^ 
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Airframe Noise Module (FNKAFW) 


OUTPUT 

USER PARAMETERS 

RS - DISTANCE FROM SOURCE TO OBSERVER 
SYSTEM PARAMETERS 
NERR - ERROR FLAG 

.TRUE., IMPLIES AN ERROR OCCURRED DURING 
MODULE EXECUTION 
.FALSE.. NO ERROR ENCOUNTERED 
DATA BASE UNIT MEMBERS 

FNKAFM(XXXNNN) - SEE FORMAT UNDER DATA BASE STRUCTURES. 

NOTE MEMBER NAME XXXNNN IS FORMED FROM 
USER PARAMETERS SCRXXX AND SCRNNN. OUTPUT 
OF THIS TABLE IS CONTROLLED BY USER 
PARAMETER, I OUT. 


DATA RA<\P ^TRIirTlIRP^ 

SFIELO(FREQ) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 

VALUES OF 1/3 OCTAVE BAND CENTER 
FREQUENCIES IN HZ 

SFIELD(THETA) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 

VALUES OF THE POLAR DIRECTIVITY ANGLE IN 
DEG 


SFIELO(PHI) - 1 RECORD MEMBER IN *RS FORMAT CONTAINING 

VALUES OF THE AZIMUTHAL DIRECTIVITY ANGLE 
IN DEG 

FNKAFM(XXXNNN) - TYPE 1 TABLE CONTAINING MEAN SQUARE 

ACOUSTIC PRESSURE AS A FUNCTION OF 

(1) FREQUENCY, (2) DIRECTIVITY ANGLE, AND 

(3) AZIMUTHAL ANGLE 


ERRORS 

NON-FATAL 

1. INSUFFICIENT LOCAL DYNAMIC STORAGE. 

2. MEMBER MANAGER ERROR OCCURRED ON SPECIFIED UNIT 
MEMBER. 

FATAL - NONE 


REMARKS 

REFERENCES 

FINK. M. R., AIRFRAME NOISE PREDICTION METHOD, FEDERAL 
AVIATION ADMINISTRATION REPORT NO. FAA-RD-77-28. MARCH 
1977. 


LDS REQUIREMENTS 

LENGTH = ( NFREQ * NTHETA * NPHI) + { NTHETA * NPHI ) + 
NFREQ + NTHETA + NPHI 

WHERE • 

NFREQ = NUMBER OF FREQUENCY VALUES 
NTHETA = NUMBER OF POLAR DIRECTIVITY ANGLES 
NPHI = NUMBER OF AZIMUTHAL DIRECTIVITY ANGLES 



O' 
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Airframe Noise Module (FNKAFM) 


GDS REQUIREMENTS 

SUFFICIENT ALLOCATION FOR TABLE FNKAFM(XXXNNN) 


4.8.9 Smith and Bushel! Turbine Noise Module (SMBTUR) 


PURPOSE - TO PREDICT THE BROADBAND NOISE FOR THE 'VORTEX' 

COMPONENT OF AN AXIAL FLOW TURBINE BY THE SMITH AND 
BUSHELL METHOD. 

REFERENCE - ASME PAPER 69-WA/6T-12, NOVEMBER 1969, 
TURBINE NOISE - ITS SIGNIFICANCE IN THE CIVIL 
AIRCRAFT NOISE PROBLEM, J. J. T. SMITH AND 
K. W. BUSHELL 

AUTHOR - CBF(L03/00/00) 

MMF(L03/00/09) 


INPUT DEFAULT 

USER PARAMETERS SI UNITS 

AE - ENGINE REFERENCE AREA (RS), M**2 PI/4 

(FT**2) 

AREA - TURBINE INLET CROSS-SECTIONAL AREA (RS), 1. 

RE AE 

C - ROTOR BLADE MEAN AXIAL CHORD DF THE LAST 1. 

STAGE (RS), RE SQRT(AE) 

CA - AMBIENT SPEED OF SOUND (RS). M/S (FT/S) 340.294 

PA - FUEL-TO-AIR RATIO (RS) 0. 

HA - ABSOLUTE HUMIDITY (RS), PERCENT MOLE 0. 

FRACTION 

lOUT - TABLE AND PRINT OUTPUT OPTION (I) 3 

0. NO PRINT, BUT GENERATE TABLE 
SMBTUR(XXXNNN) 

-1. PRINT OUTPUT IN DB UNITS, BUT DO 
NOT GENERATE TABLE SMBTUR(XXXNNN) 


-2. PRINT OUTPUT IN DIMENSIONLESS FORM, 

BUT DO NOT GENERATE TABLE 
SMBTUR(XXXNNN) 

-3, BOTH OPTIONS 

1, PRINT OUTPUT IN DB UNITS AND 
GENERATE TABLE SMBTUR(XXXNNN) 

2, PRINT OUTPUT IN DIMENSIONLESS FORM 
AND GENERATE TABLE SMBTUR(XXXNNN) 

3, BOTH OPTION 1 AND 2 

IPRINT - PRINT FLAG (I) 3 

0, NO PRINT DESIRED 

1, INPUT PRINI ONLY 

2, OUTPUT PRINT ONLY 

3, BOTH INPUT AND OUTPUT PRINT 

lUNITS - INPUT UNITS FLAG 2HSI 

2HSI, SI UNITS 
7HENGLISH, ENGLISH UNITS 

MA - AIRCRAFT MACH NUMBER (RS) 0. 

MOOT - CORE MASS FLOW RATE (RS), RE RHOA*CA*AE .2 

N - ROTATIONAL SPEED (RS), RE CA/D .3 
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Smith and Bushel! Turbine Noise Module (SMBTUR) 


NENG - 
NS 

RHOA - 
RS 

SCRNNN - 

SCRXXX - 

STIME - 
TSJ 


NUMBER OF ENGINES 
NUMBER OF TURBINE STAGES 


AMBIENT DENSITT (RS), KG/M**3 
(SLUG/FT**3) 

DISTANCE FROM SOURCE TO PSEUDO OBSERVER 
(RS). M (FT) 

INTEGER VALUE, NNN, .GT. 0 USED TO FORM 
TABLE UNIT MEMBER NAME SMBTUR(XXXNNN) 
THREE LETTER CODE, XXX, USED TO FORM 
TABLE UNIT MEMBER NAME SMBTUR(XXXNNN) 
SOURCE TIME 

EXIT STATIC TEMPERATURE (RS), RE TA 


DATA BASE UNIT MEMBERS 
(DESCRIBED UNDER DATA BASE STRUCTURES) 
SFIELD(FREQ) ' 

SFIELD(THETA) 

SFIELD(PHI) 


1 

1 


1.225 


001 

3HXXX 

0 . 

2 . 


OUTPUT 

USER PARAMETERS 

RS - DISTANCE FROM SOURCE TO OBSERVER 


SYSTEM PARAMETERS 
NERR - ERROR FLAG 

.TRUE,, IMPLIES AN ERROR WAS ENCOUNTERED 
DURING MODULE EXECUTION 
.FALSE., NO ERROR ENCOUNTERED 
DATA BASE UNIT MEMBERS 

SMBTUR(XXXNNN) SEE FORMAT UNDER DATA BASE STRUCTURES 
NOTE MEMBER NAME XXXNNN IS FORMED FROM 
USER PARAMETERS SCRXXX AND SCRNNN. OUTPUT 
OF THIS TABLE IS CONTROLLED BY USER 
PARAMETER, lOUT. 


DATA BASE STRUCTURES 


SFIELD(FREQ) 
SFIELD(THETA) 
SFIELO(PHI) 
SMBTUR(XXXNNN) 


1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF 1/3 OCTAVE BAND CENTER 
FREQUENCIES IN HZ 

1 RECORD MEMBER IN *RS FORMAT CONTAINING 
VALUES OF THE POLAR DIRECTIVITY ANGLE IN 
DEG 

I RECORD MEMBER IN *RS FORMAT CONTAINING 
IN^DW AZIMUTHAL DIRECTIVITY ANGLE 

TYPE 1 TABLE CONTAINING MEAN SQUARE 
ACOUSTIC PRESSURE AS A FUNCTION OF 
(1) FREQUENCY, (2) DIRECTIVITY ANGLE, 
and (3) AZIMUTHAL ANGLE 


Smith and Bushel 1 Turbine Noise Module (SMBTUR) 


j* 

■%* 


ERRORS 

NON-FATAL 

1. INSUFFICIENT LOCAL DYNAMIC STORAGE. 

2. MEMBER MANAGER ERROR OCCURRED ON SPECIFIED UNIT 
MEMBER. 

FATAL - NONE 

REMARKS 

REFERENCES 

SMITH, J. J. T., AND BUSHELL, K. W., TURBINE NOISE - ITS 
SIGNIFICANCE IN THE CVIL AIRCRAFT NOISE PROBLEM, 
ASME PAPER 69-WA/GT-lk, NOVEMBER 1969. 

LDS REQUIREMENTS 

LENGTH » ( NFREQ * NTHETA * NPHI ) + ( NTHETA * NPHI ) 

+ NFREQ + NTHETA NPHI 

WHERE 

NFREQ = NUMBER OF FREQUENCY VALUES 
NTHETA » NUMBER OF DIRECTIVITY ANGLES 
NPHI « NUMBER OF AZIMUTHAL ANGLES 

GDS REQUIREMENTS 

SUFFICIENT ALLOCATION FOR TABLE SMBTUR(XXXNNN) 
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5 AMOPP CONTROL STATEMENT PROCEDURE LIBRARY 


5.1 OVURVIKW 

The ANOPP control stat«ment procedure library ta ® 

„a,*ar, aontalnlM oo«»only u.ad aaquanoaa f 

Stored on the ANOPP permanent data base aa data unit snabloa the 

able for uao In any ANOPP run. Uae of the procedure library enablea tne 

aaer to nave time by reduclnq the number of uaer supplied control 
Rtfttamaatfl. 

There are four cateqorlea of procedures contained in the library, jmey 
can bridentlfied by the format of the member name, -me four cateqorlea are 

as followsj 

1 . Noiae prediction with dimen8lor^J j£Ut8 . These procedures take the 
Inout noi8e“^dlctlon parameters, convert the input parameters to th 
XerTm“nrio.le,s form tor the nolee prediction 

e«,d«le. we member nemee tor theee “the fl“lSVod- 

sional inputs, procedure DHDNPAN should be used. 

2. Tima- dependent noise prediction . These procedures predict 

irieliLlnr- wl^r: 

rUe"? jn»oo\Trsi'Jqie"i«,rcuci?;r^ ;L“d:i:-(sai.ET. tor 

time-dependent predictions, procedure TSGLJET should be used. 

3 Mrhania-aaanenc inq procedures. These procedures execute a series of 
functional modules that are normally executed in a fixed order. ® 
«a“rertrLfer of deta base mambera and parameters from one m^ole to the 

Txf rs\.ndled -bometloell, ^or t^e use. J^Vr'-Ie-r'c^e'^ the 
procedures are of the form XXXYYY, wnere xaa is a 

* - - a _ „ a vvv A three— letter code describinq the 

tor example, the '^,„rerwe 

single noise source to the observer , ,gpp) 

NoiL Levels Module (LEV), and the Effective Noise Module (EPF). 

a tnternel llbrerv procedures. Wese prooedo-ea ate used Internally 
elthl^ thrtlb^ery to pL^rm ' ^ a teeha, ‘^."trdrrU'tirb; 

rurr.-wVL^Tberj-er^^^^ 

:o5;te\«e!“roraL“pU:\hrpro” tnlla procedure XOErm to 

execute the functional module GETUR# 

ANOPP procedures from the library are executed usinq ^^®. 
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bers listed as inputs and outputs in section 5.2. Itie capability for 
parameter-name substitution by the user does not exist for the procedure 

library. 

As an example of ANOPP procedure usage, a request to produce the atmo 
sphere and atmospheric absorption tables for a constant, standard-sea-level 
atmosphere using procedure ATMDAT results in the following: 


CREATE ATMCON $ 

UPDATE NEWU=ATMCON SOURCB>=* $ 

-ADDR 0LDM»1N PORMAT=4H3RS$ $ 

0. 288.15 0. $ 

END* $ 

PARAM IPRINT=3 $ 

SETSYS JECHO=. FALSE. JLOG«« FALSE. $ 

CALL PROCLIB(ATMDAT) ATM=ATMCON $ 

SETSYS JECHO».TROE. JL0G=.TR0E. $ 

Note the following three aspects of this example: 

1 . Since a function of ATMDAT is to provide the SFIELD array, the user 

is not required to provide it. 

2. The SETSYS before the CALL CS eliminates the print caused by the 

secondary edit phase and the execution of the procedure member. 

3. The input and output members for the procedure are on unit ATMCON 

since this name is provided on the CALL CS. 


5.2 PROCEDURE DESCRIPTIONS 

This section contains the prologues which describe the ANOPP procedures 
in the library. Each prologue is headed by the name of the procedure it 
describes. Figure 1 shows the format for the prologues. 


♦♦♦♦PROCEDURE - name 

PURPOSE - short description of the procedure (1-2 sentences) 

AUTHOR - Initials and level number, such as LOl/00/00 
input MODULES 

USER PARAMETERS 

Namei - description - default value - referencing modules 


Namen - description - default value - 
MEMBERS AND TABLES 

DATA UNIT(DATA MEMBER) - description 

OUTPUT 

USER PARAMETERS 

Same as for INPUT 
MEMBERS AND TABLES 
Same as for INPUT 

LOCAL 

USER PARAMETERS 

Same as for INPUT 
MEMBERS AND TABLES 


referencing modules 
MODULES 

referencing modules 

MODULES 

MODULES 

MODULES 


Same as for INPUT 

FUNCTIONS - description of the basic functions performed by the procedure In 
the order they are performed. 

PROCEDURES CALLED - list of the procedures called by this procedure, 

CALLING PROCEDURES - list of other procedures that call this procedure. 


Figure 1,- ANOPP procedure prologue format. 


PROCEDURE PROCUB ( ATMDAT ) 


♦♦♦♦PROCEDURE ATMDAT 

PURPOSE - TO GENERATE THE ATMOSPHERIC DATA AND ATMOSPHERIC 
ABSORPTION DATA FOR A USER SPECIFIED TEMPERATURE 
PROFILE. 

AUTHOR - DSW(L03/00/00) 

0SW(L03/00/05) 

INPUT 

USER PARAMETERS MODULES 

GRNALT GROUND LEVEL ALTITUDE (M).(FT) (RS) ATM 

(DEFAULT*0.) 

6RNPRES ATMOSPHERIC PRESSURE AT GROUND LEVEL ATM 

(N/M^^2).(LB/FT^^2) (RS) (DEFAULT* 

101325. N/M^^2) 

NALT NUMBER OF ALTITUDES FOR OUTPUT (I) IF. ATM, 
(DEFAULT* 10) PARAM 

DELALT ALTITUDE INCREMENT FOR OUTPUT (M).(FT) ATM 

(RS) (0EFAULT*100, M) 

ATMPRT ATM OUTPUT PRINT OPTION (I) ATM 

=0 NO PRINT (DEFAULT) 

*1 INPUT PRINT ONLY 

*2 OUTPUT PRINT ONLY 

*3 BOTH INPUT AND OUTPUT PRINT 

ABSPRT ABS OUTPUT PRINT OPTION (I) ABS 

*0 NO PRINT (DEFAULT) 

*1 INPUT PRINT ONLY 

=2 OUTPUT PRINT ONLY 

*3 BOTH INPUT AND OUTPUT PRINT 

ATMOS ATMOSPHERE OPTION (L) IF, 

^-.TRUE. - GENERATE ATMOSPHERIC TABLE PARAM 
(DEFAULT) 

*. FALSE.- NO TABLE 

NOTE: IF ATMOS*. FALSE. AND ABSORP*.TRUE. , 

THEN USER MUST PROVIDE ATM(TMOD). 

A8S0RP ATMOSPHERIC ABSORPTION OPTION (L) IF. 

*.TRUE. - GENERATE ATMOSPHERIC PARAM 

ABSORPTION TABLE (DEFAULT) 

*. FALSE.- NO TABLE 

lUNITS INPUT UNITS OPTION (A) IF, 

=2HSI - INPUT IN SI UNITS (DEFAULT) PARAM 
*7HENGLISH- INPUT IN ENGLISH UNITS 
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PROCEDURE PROCLIB ( ATMDAT ) 


MEMBERS MODULES 

ATM (IN ) MULTI-RECORD FORMAT IN 3RS FORMAT OF ATM 
TEMPEfxATURE AND HUMIDITY PROFILE: 

(NOT REQUIRED IF ATMOS», FALSE.) 

RECORD WORD DESCRIPTION 

1 F0RMAT=3RS 

1 ALTITUDE ABOVE SEA LEVEL 

2 TEMPERATURE 

3 PERCENT RELATIVE HUMIDITY 

2 (SAME AS 1) 


N LAST ENTRY IN PROFILE 

SFIELD(FREQ) ONE-RECORD MEMBER IN *RS FORMAT ABS 

OF THE VALUES OF FREQUENCY IN HERTZ 


OUTPUT 

USER PARAMETERS - NONE 


MEMBERS MODULES 

ATM (TMOO ) TYPE 1 DATA TABLE OF ATMOSPHERIC ATM.ABS 
DATA AS A FUNCTION OF ALTITUDE. 

ATM (AAC ) TYPE 1 DATA TABLE OF ATMOSPHERIC ABS 

ABSORPTION DATA AS A FUNCTION OF 
ALTITUDE AND FREQUENCY. 

LOCAL 

USER PARAMETERS MODULES 

ABSINT NUMBER OF INTEGRATION STEPS =5 ABS 


SAE METHOD FOR ABSORPTION TABLE BASED ON PREDICTION 
PROCEDURE USED (L) 

=.TRUE. - FOR PREDICTION PROCEDURES REQUIRING 
SAE ARP 866A ABSORPTION 
=. FALSE.- OTHERWISE (DEFAULT) 

MEMBERS MODULES 

SCRATCH (TABl ) TYPE 1 TABLE OF THE CONTENTS ATM 

OF ATM (IN ). 
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PROCEDURE PROCLIB ( ATMUAT ) 


FUNCTIONS 

1. LOAD SFIELD UNIT IF NOT ASSIGNED. 

2. SET INPUT PARAMETERS FOR ATM MODULE. 

3. EXECUTE ATM MODULE. 

4. SET INPUT PARAMETERS FOR ABS MODULE. 

5. EXECUTE ABS MODULE. 

MODULES CALLED - ABS ATM 
PROCEDURES CALLED - XABS XATM 
CALLING PROCEDURES - NONE 
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PROCEDURE PROCLIB ( ATMSTO ) 


♦♦♦♦PROCEDURE ATMSTD 

PURPOSE - TO LOAD THE STANDARD ATMOSPHERE AND STANDARD 

ATMOSPHERIC ABSORPTION TABLES FROM THE PERMANENT DATA 
BASE. 

AUTHOR - DSW(L03/00/00) 

INPUT - NONE 
OUTPUT 

USER PARAMETERS - NONE 
MEMBERS 

ATM (TMOD ) TYPE 1 DATA TABLE OF STANDARD 

ATMOSPHERIC DATA AS A FUNCTION OF 
ALTITUDE. 

ATM (AAC ) TYPE 1 DATA TABLE OF STANDARD 

ATMOSPHERIC ABSORPTION DATA AS A 
FUNCTION OF ALTITUDE AND FREQUENCY 


MODULES 

LOAD 

LOAD 


LOCAL 

USER PARAMETERS 

SAE METHOD FOR ABSORPTION TABLE BASED ON PREDICTION 

PROCEDURE USED (L) 

=.TRUE. - FOR PREDICTION PROCEDURES REQUIRING 
SAE ARP 866A ABSORPTION 
=. FALSE.- OTHERWISE (DEFAULT) 

MEMBERS - NONE 

FUNCTIONS 

1. LOAD STANDARD ATMOSPHERE TABLE 

2. LOAD PROPER ATMOSPHERIC ABSORPTION TABLE 

MODULES CALLED - NONE 
PROCEDURES CALLED - NONE 
CALLING PROCEDURES - NONE 
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PROCEDURE PROCLIB ( OCNLJET ) 


★♦♦♦procedure OCNLJET 


miDDncc rn Allow EXECUTION OF THE DUAL STREAM COANNULAR JET 
PURPOSE - JQ^LLOW EXECUTIUN 

aESmS oF ?HE JErNmSE PARAHETERS MODULE IS NOT 
DESIRED. 

AUTHOR - DSW(L03/00/00) 

0SW(L03/00/05) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS 


NEN6 NUMBER OF ENGINES (I) 

RS DISTANCE FROM NOZZLE EXIT TO OBSERVER, 
IMI (FT) (RS) {OEFAULT=l. M) 
delta mil BETWEEN FLIGHT f CTOR AND ENGINE 
INLET AXIS (DEGREES) (RS) (OE^JULT-O.) 

A1 PRIMARY JET AREA (M**2) ,(FT**2) (RS) 

T1 PRIMARY^JET^TOTAL * 

VI PRIMARY JEt\eLOCITMM/S^ (RS) 

(DEFAULT* 340. 294 M/S) 

RHOl PRIMARY JET DENSITY (KG/M**3) , 

(SLUG/FT**3) (RS) 

(DEFAULT*!. 225 KG/M**3) 

GAMMA! RATIO OF SPECIFIC HEATS FOR PRIMARY 

JET (RS) (DEFAULT*!. 4) ^ 

A2 SECONDARY JET AREA (M**2) ,(FT**2) (RS) 

dh2 seSary^jet hydraulic diameter (M). 

(FT) (RS) (DEFAULT*SQRT(PI/4.) M) 

T2 SECONDARY JET TOTAL TEMPERATURE 

(DEG K).(OEG R) (RS) 

(DEFAULT*288.!5 DEG K) 

V2 kcONDARY JET VELOCITY (M/S). (FT/S) 

(RS) (DEFAULT*0.) 

RH02 kcONOARY JET DENSITY (KG/M**3), 

(SLUGS/FT**3) (RS) 

DEFAULT*!. 225 KG/M**3) 

GAMMA2 RATIO OF SPECIFIC HEATS FOR SECONDARY 
JET (RS) (DEFAULT*!. 4) 

CA AMBIENT SPEED OF SOUND (M/S), (FT/S) 
(RS) (DEFAULT*340.294 M/S) 

RHOA AMBIENT DENSITY (KG/M**3) .(SLUG/FT* 3) 

(RS) (DEFAULT*!. 225 KG/M**3) 


MODULES 

CNLJET 

CNLJET 

IF.PARAM 

CNLJET 

CNLJET, PARAM 
IF, EVALUATE 
CNLJET, PARAM 
IF, EVALUATE 
CNLJET, PARAM 
IF, EVALUATE 
CNLJET, PARAM 
IF. EVALUATE 

CNLJET 

CNLJET. PAP AM 
IF.EVALUK.E 
CNLJET .PARAM 
IF .EVALUATE 
CNLJET, PAR AM 
IF .EVALUATE 

CNLJET .PARAM 
IF, EVALUATE 
CNLJET .PARAM 
IF, EVALUATE 

CNLJET 

CNLJET, PARAM 
IF, EVALUATE 
CNLJET, PARAM 
IF > EVALUATE 
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PROCEDURE PROCLIB ( DCNUET ) 


TA AMBIENT TEMPERATURE (DEG K),(DEG R) 

(RS) (DEFAULT=288.15 DEG K) 

VO AIRCRAFT VELOCITY (M/S), (FT/S) (RS) 
(DEFAULT-0.) 

STIME SOURCE TIME AT WHICH NOISE IS CALCULATED 
(S) (RS) (DEFAULT»0.) 

SCRXXX THREE LETTER ID USED TO FORM TABLE NAME 
CNLJET(XXXNNN) (A) (DEFAULT«3HXXX) 

SCRNNN VALUE USED TO FORM TABLE NAME 
CNLJET(XXXNNN) (I) (DEFAULT=1) 

I OUT OUTPUT CODE FOR TABLE AND PRINTED OUTPUT 

(I) (DEFAULT=3) 

0 - NO PRINT BUT GENERATE CNLJET(XXXNNN) . 
-1 - Ol’TPUT PRINT IN DB BUT NO TABLE. 

-2 - OUTPUT PRINT IN DIMENSIONLESS FORM 
BUi NO TABLE. 

-3 - OUTPUT PRINT IN DIMENSIONLESS FORM 
AND DB BUT NO TABLE. 

1 - OUTPUT PRINT IN DB AND GENERATE 

CNLJET(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE CNLJET(XXXNNN). 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND DB AND GENERATE CNLJET(XXXNNN) . 
IPRINT OUTPUT PRINT CODE (I) (DEFAULT*3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 
lUNITS UNIT OPTION CODE (A) (DFFAULT=2HSI) 

2HSI - SI UNITS 
7HENGLISH - ENGLISH UNITS 

MEMBERS 

SFIELD (FREQ ) - ONE RECORD MEMBER OF THE VALUES 
OF FREQUENCY IN HERTZ. 

SFIELD (THETA) - ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

SFIELD (PHI ) - ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 

JWRCOAN(OM ) - TYPE 1 DATA TABLE OF THE JET 
VARIABLE DENSITY EXPONENT. 
JWRCOAN(PDF ) - TYPE 1 DATA TABLE OF THE POWER 
DEVIATION FACTOR. 

JWRCOAN(Sl ) - TYPE 1 DATA TABLE OF THE PEAK 
STROUHAL NUMBER FOR THE FIRST 
SPECTRUM COMPONENT. 


IF.PARAM 

EVALUATE 

IF.PARAM 

EVALUATE 

CNLoET 

CNLJET 

CNLJET 

CNLJET 


CNLJET 

IF.PARAM, 

CNLJET 

MODULES 

CNLJET 

CNLJET 

CNLJET 

CNLJET 

CNLJET 

CNLJET 
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PROCEDURE PROCLIB ( DCNUET ) 


JWRCOAN(S2 ) 

JWRCOAN(NSF ) 
JWRCOAN( ALPHA) 

JWRCOAN(CBF ) 
JWRCOAN(DIR ) 
JWRCOAN(MTH ) 


- TYPE 1 DATA TABLE OF THE PEAK 
STROUHAL NUMBER FOR THE SECOND 
SPECTRUM COMPONENT. 

- TYPE 1 DATA TABLE OF THE 
NORMALIZED SPECTRUM FUNCTION. 

- TYPE 1 DATA TABLE OF THE RATIO 
OF THE SECOND COMPONENT SPECTRAL 
PEAK TO THE FIRST COMPONENT 
SPECTRAL PEAK. 

- TYPE 1 DATA TABLE OF THE 
COANNULAR BENEFIT FACTOR. 

- TYPE 1 DATA TABLE OF THE 
NORMALIZED DIRECTIVITY FUNCTION. 

- TYPE 1 DATA TABLE OF THE 
FORWARD VELOCITY INDEX. 


CNLJET 

CNLJET 

CNLJET 

CNLJET 

CNLJET 

CNLJET 


OUTPUT 

USER PARAMETERS 


MODULES 


RS 

CNLERR 


DISTANCE FROM SOURCE TO OBSERVER (M),(FT) CNLJET 
(RS) 

ERROR PARAMETER (I) CNLJET 

0 - NO ERRORS ENCOUNTERED 

1 - MEMBER MANAGER ERROR OCCURRED ON OPEN. 

2 - INSUFFICIENT LDS AVAILABLE. 

3 - MEMBER MANAGER ERROR OCCURRED ON READ. 

4 - AT LEAST ONE USER PARAMETER HAS AN 

INVALID VALUE. 

5 - UNABLE TO BUILD TABLE CNLJET(XXXNNN). 

6 - AN INVALID VALUE WAS CALCULATED DURING 

EXECUTION. 


MEMBERS 


MODULES 


CNLJET(XXXNNN) 


- TYPE 1 DATA TABLE OF THE 
MEAN-SQUARE ACOUSTIC PRESSURE. 


CNLJET 


LOCAL 

USER PARAMETERS 


MODULES 


MA 

AIRCRAFT MACH NUMBER (RS) 

CNLJET. 

EVALUATE 

AE 

ENGINE REFERENCE AREA (M**2) .(FT**2) 

PARAM. CNLJET 

(RS) 

9 ELEMENT PARAMETER FOR SAVING INPUT 

EVALUATE 

TEMP 

PARAM. 

VALUES (RS) 

EVALUATE 


MEMBERS - NONE 
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PROCEDURE PROCLIB ( DCNUET ) 


FUNCTIONS 

1. LOAD SFIELD AND JWRCOAN DATA UNITS IF NOT ASSIGNED. 
2* INITIALIZE DEFAULT VALUES OF USER PARAMETERS IF NOT 

3. COMPUTE ‘dimensionless INPUTS TO MODULE CNLJET. 

4. EXECUTE MODULE CNLJET. 

MODULES CALLED - CNLJET 
PROCEDURES CALLED - XCNLJET 
CALLING PROCEDURES - NONE 


PROCEDURE PROCUB ( DFNKAFM ) 


****PROCEOURE DFNKAFM 


PURPOSE - 


AUTHOR 


airframe NOISE MODULE WITH 
DIMENSIONAL INPUTS. USEFUL WHEN EXECUTION OF THE 
AIRFRAME NOISE PARAMETERS MODULE IS NOT DESIRED. 

DSW(L03/00/00) 

DSW(L03/00/05) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS 


MODULES 


AF 

AH 

AV 

AW 

BF 

8H 

BV 

BW 

DELTAF 

DM6 

DNG 

LM6 

LN6 

CA 

RHOA 

MUA 

RS 

VO 

STIME 


FLAP AREA (M**2) .(FT**2) (RS) 

(DEFAULT«10. M**2) 

HORIZONTAL TAIL AREA (M**2) .(FT**2) (RS) 
(DEFAULT»20. M**2) ' ^ ' 

VERTICAL TAIL AREA (M**2) ,(FT**2) (RS) 
(DEFAULT»20. M**2) ^ 

WING AREA (M**2),(FT**2) (RS) 

(0EFAULT*100. M**2) 

FLAP SPAN (M).(FT) (RS) (OEFAULT=5. M) 

HORIZONTAL TAIL SPAN (M),(FT) (RS) ' 
(DEFAULT=10. M) ^ \ \ i 

VERTICAL TAIL SPAN (M),(FT) (RS) 

(DEFAULT=10. M) ' ^ 

WING SPAN (M).(FT) (RS) (DEFAULT«20. M) 

FLAP SETTING (DEG) (RS) (DEFAULT«0. ) 

JlJx LANDING GEAR (M). 

(FT) (RS) (DEFAULT=1. M) ^ ' 

TIRE DIAMETER OF NOSE LANDING GEAR (M) . 

(FT) (RS) (DEFAULT=1. M) ' ^ 

MAIN LANDING GEAR STRUT LENGTH (M).(FT) 

(RS) (DEFAULTS. M) ^ l 

NOSE LANDING GEAR STRUT LENGTH (M),(FT) 

(RS) (DEFAULT=3. M) v /.v 

AMBIENT SPEED OF SOUND (M/S), (FT/S) 

(RS) (DEFAULT»340.294 M/S) ^ 

AMBIENT DENSITY (K6/M**3) ,(SLU6/FT**3) 

(RS) (DEFAULT»1.225 KG/M**3) ^ 

AMBIENT DYNAMIC VISCOSITY (K6/(M S)), 

(SLUG/(FT S)) (RS) ^ 

( DEFAULT* 1.7894E-5 K6/(M S)) 

JnFpUmT OBSERVER (M).(FT) IF,PAR/« 

VUtrAULT»l* M) FNkAFM 


FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 


PARAM.FNKAF 

IF.EVALUAT 

FNKAFM 

FNKAFM 
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PROCEDURE PROCLIB ( DFNKAFM ) 


NWMG 

NWNG 

NMG 

NNG 

NS 

IPRINT 
I OUT 


SCRNNN 

SCRXXX 

DYNCLN 

DELTAW 

LANDG 

lUNITS 


NUMBER OF WHEELS PER MAIN LANDING GEAR 
(I) (DEFAULT«4) 

NUMBER OF WHEELS PER NOSE LANDING GEAR 
(I) (DEFAULT«2) 

NUMBER OF MAIN LANDING GEAR (I) 

(DEFAULT=2) 

NUMBER OF NOSE LANDING GEAR (I) 

(DEFAULT=1) 

NUMBER OF SLOTS FOR TRAILING EDGE FLAPS 
(n (D£FAULT=3) 

OUTPUT PRINT CODE (I) (DEFAULT® 3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

OUTPUT CODE FOR TABLE AND PRINTED OUTPUT 
(I) (DEFAULT® 3) 

0 - NO PRINT BUT GENERATE FNKAFM(XXXNNN) . 
-1 - OUTPUT PRINT IN DB BUT NO TABLE 

-2 - OUTPUT PRINT IN DIMENSIONLESS FORM 
BUT NO TABLE. 

-3 - OUTPUT PRINT IN DIMENSIONLESS FORM 
AND DB BUT NO TABLE. 

1 - OUTPUT PRINT IN OB AND GENERATE 

FNKAFM(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE FNKAFM(XXXNNN) . 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND DB AND GENERATE FNKAFM(XXXNNN) . 
VALUE USED TO FORM TABLE NAME 
FNKAFM(XXXNNN) (I) (DEFAULT®!) 

THREE LETTER ID USED TO FORM "ABLE NAME 
FNKAFM(XXXNNN) (A) (DEFAULT® 3KXXX) 
DESCRIPTION OF AIRCRAFT (L) 

(DEFAULT®. FALSE.) 

.TRUE. - AERODYNAMICALLY CLEAN .dRCRAFT 
.FALSE. - NON-AERODYNAMICALLY CLEAN 
AIRCRAFT 

TYPE OF WING PLANFORM (L) 

(DEFAULT®. FALSE.) 

.TRUE. - DELTA-WINGED AIRCRAFT 
.FALSE. - RECTANGULAR-WINGED AIRCRAFT 
LANDING GEAR POSITION (A) (DE FAULT® 4HDOWN) 
4HDOWN - GEAR DOWN 
4HUP - GEAR UP 

UNIT OPTION CODE (A) (DEFAULT=2HSI) 

2HSI - SI UNITS 
7HENGLISH - ENGLISH UNITS 


FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 


FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 
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PROCEDURE PROCLIB ( DFNKAFM ) 


THE NEXT SEVEN PARAMETERS HAVE THE FOLLOWING VALUES 
.TRUE. - INCLUDE IN TOTAL PREDICTION 
.FALSE. - DO NOT INCLUDE 


TEWN 

TRAILING EDGE WING NOISE (L) 
(DEFAULT^. TRUE.) 

FNKAFM 

TEHTN 

TRAILING EDGE HORIZONTAL TAIL NOISE (L) 
(DEFAULT-. TRUE.) 

FNKAFM 

TEVTN 

TRAILING EDGE VERTICAL TAIL NOISE (L) 
(DEFAULT-.TRUE.) 

FNKAFM 

TEFN 

TRAILING EDGE FLAP NOISE (L) 
(DEFAULT-. FALSE.) 

FNKAFM 

LESN 

LEADING EDGE SLAT NOISE (L) 
(DEFAULT-. FALSE.) 

FNKAFM 

MLGN 

MAIN LANDING GEAR NOISE (L) 
(DEFAULT-.TRUE.) 

FNKAFM 

NLGN 

NOSE LANDING GEAR NOISE (L) 
(DEFAULT-.TRUE.) 

FNKAFM 


MEMBERS MODULES 


SFIELD(FREQ ) - ONE RECORD MEMBER OF THE VALUES FNKAFM 
OF FREQUENCY IN HERTZ. 

SFIELD(THETA) - ONE RECORD MEMBER OF THE VALUES FNKAFM 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

SFIELD(PHI ) - ONE RECORD MEMBER OF THE VALUES FNKAFM 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 

OUTPUT 


USER PARAMETERS MODULES 

RS DISTANCE FROM SOURCE TO OBSERVER (M),(FT) FNKAFM 
(RS) 

MEMBERS MODULES 

FNKAFM(XXXNNN) - TYPE 1 DATA TABLE OF THE FNKAFM 

MEAN-SQUARE ACOUSTIC PRESSURE. 

LOCAL 

USER PARAMETERS MODULES 

MA AIRCRAFT MACH NUMBER (RS) FNKAFM. 


EVALUATE 

MEMBERS - NONE 
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PROCEDURE PROCLIB ( DFNKAFM ) 


FUNCTIONS 

1. LOAD SFIELO DATA UNIT IF NOT ASSIGNED. 

INITIALIZE DEFAULT VALUES OF USER PARAMETERS IF NOT 

3. COMPUTE ‘dimensionless INPUT TO MODULE FNKAFM. 

4. EXECUTE MODULE FNKAFM. 

MODULES CALLED - FNKAFM 
PROCEDURES CALLED - XFNKAFM 
CALLING PROCEDURES > NONE 


PROCEDURE PROCLIB ( DGECOR ) 


****PROCEOURE DGECOR 

PURPOSE - TO ALLOW EXECUTION OF THE COMBUSTION NOISE MODULE 
WITH DIMENSIONAL INPUTS. USEFUL WHEN EXECUTION OF 
THE CORE NOISE PARAMETERS MODULE IS NOT DESIRED. 

AUTHOR - DSW(L03/00/00) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS MODULES 


NEN6 

RS 

A 

MDOT 

VO 

PI 

TI 

TJ 

TDDELT 

CA 

PA 

TA 

RHOA 

Si IME 

SCRXXX 

SCRNNN 


NUMBER OF ENGINES (I) (DEFAULT*!) GECOR 

DISTANCE FROM SOURCE TO OBSERVER (M),(FT) GECOR 
(RS) (DEFAULT*!. M) IF.PARAM 

COMBUSTOR ENTRANCE AREA (M**2) ,(FT**2) IF, EVALUATE 
(RS) (0EFAULT*PI/4. M**2) PARAM, GECOR 

co» :tor entrance mass flow rate if, evaluate 

(Ku/S), (SLUG/S) (RS) (0EFAULT*65 KG/S) PARAM,6EC0R 
AIRCRAFT VELOCITY (M/S), (FT/S) (RS) IF, EVALUATE 
(DEFAULT*0.) PARAM,GECOR 

COMBUSTOR ENTRANCE TOTAL PRESSURE IF, EVALUATE 

(N/M**2),(LB/FT**2) (RS) PARAM,GECOR 

(DEFAULT*!0!325. N/M**2) 

COMBUSTOR ENTRANCE TOTAL TEMPERATURE IF, EVALUATE 
(DEG K),(DEG R) (RS) PARAM,GECOR 

(DEFAULT* 288.! 5 DEG K) 

COMBUSTOR EXIT TOTAL TEMPERATURE IF, EVALUATE 

(DEG K),(OEG R) (RS) PARAM,GECOR 

(DEFAULT*576.30 DEG K) 

DESIGN TURBINE TEMPERATURE RISE IF, EVALUATE 

(DEG K),(DE6 R) (RS) PARAM,6EC0R 

(DEFAULT*! 44. 07 DEG K) 

AMBIENT SPEED OF SOUND (M/S), (FT/S) IF, EVALUATE 
(RS) (DEFAULT* 340. 294 M/S) PARAM,6EC0R 

AMBIENT PRESSURE (N/M**2) ,(LB/FT**2) IF, PARAM, 
(RS) (DEFAULT*!0!325. N/M**2) EVALUATE 

AMBIENT TEMPERATURE (DEG K),(DE6 R) IF, PARAM, 
(RS) (DEFAULT»288.!5 DEG K) EVALUATE 

AMBIENT DENSITY (KG/M**3) ,(SLUG/FT**3) IF,EVALUATE 
(RS) (DEFAULT*!. 225 KG/M*»3 ) PARAM,6EC0R 

SOURCE TIME AT WHICH NOISE IS COMPUTED GECOR 
(S) (RS) (DEFAULT*0.) 

THREE LETTER ID USED TO FORM TABLE NAME GECOR 
GECOR(XXXNNN). (A) (DEFAULT*3HXXX) 

VALUE USED TO FORM TABLE NAME GECOR 

GECOR(XXXNNN) (I) (DEFAULT*!) 
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PROCEDURE PROCLIB ( DGECOR ) 


lOUT OUTPUT CODE FOR TABLE AND PRINTED OUTPUT 
(I) (DEFAULT=3) 

0 - NO PRINT BUT GENERATE GECOR(XXXNNN) . 

-1 - OUTPUT PRINT IN DB BUT NO TABLE. 

-2 - OUTPUT PRINT IN DIMENSIONLESS FORM 
BUT NO TABLE. 

-3 - OUTPUT PRINT IN DIMENSIONLESS FORM 
AND DB BUT NO TABLE. 

1 - OUTPUT PRINT IN DB AND GENERATE 

GECOR(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE GECOR(XXXNNN) . 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND OB AND GENERATE GECOR(XXXNNN) . 

IPRINT OUTPUT PRINT CODE (I) (DEFAULT*3) GECOR 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

lUNITS UNIT OPTION CODE (A) (DEFAULT=2HSI) GECOR 

2HSI - SI UNITS 

7HENGLISH - ENGLISH UNITS 

MEMBERS MODULES 


SFIELD(FREQ ) 
SFIELD(THETA ) 

SFIELD(PHI ) 


ONE RECORD MEMBER OF THE VALUES GECOR 
OF FREQUENCY IN HERTZ. 

ONE RECORD MEMBER OF THE VALUES GECOR 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

ONE RECORD MEMBER OF THE VALUES GECOR 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 


OUTPUT 

USER PARAMETERS MODULES 


RS RADIAL DISTANCE FROM SOURCE TO OBSERVER GECOR 
(M).(FT) (RS) 

6ECERR ERROR PARAMETER (I) GECOR 

0 - NO ERRORS ENCOUNTERED. 

1 - MEMBER MANAGER ERROR OCCURRED ON OPEN. 

2 - INSUFFICIENT LDS AVAILABLE. 

3 - MEMBER MANAGER ERROR OCCURRED ON READ. 

4 - AT LEAST ONE USER PARAMETER HAS AN 

INVALID VALUE. 

5 - UNABLE TO BUILD TABLE GECOR(XXXNNN) . 

6 - AN INVALID VALUE WAS CALCULATED 

DURING EXECUTION. 
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PROCEDURE PROCLIB ( DGECOR ) 


MEMBERS MODULES 

6EC0R (XXXNNN) - TYPE 1 DATA TABLE OF THE GECOR 

MEAN-SQUARE ACOUSTIC PRESSURE. 

LOCAL 


USER PARAMETERS 

MODULES 

MA 

AIRCRAFT MACH NUMBER (RS) 

tVALUATE, 

GECOR 

TEMP 

6 ELEMENT PARAMETER FOR SAVING INPUT 

PARAM, 

AE 

VALUES (RS) 

EVALUATE 

ENGINE REFERENCE AREA (M**2) ,(FT**2) 

PAR AM. GECOR 


(RS) 

EVALUATE 

MEMBERS - 

NONE 



FUNCTIONS 


1. LOAD SFIELD DATA UNIT IF NOT ASSIGNED. 

2. INITIALIZE DEFAULT VALUES OF USER PARAMETERS IF NOT 
DEFINED. 

3. COMPUTE DIMENSIONLESS INPUTS TO MODULE GECOR. 

4. EXECUTE MODULE GECOR. 

MODULES CALLED - GECOR 
PROCEDURES CALLED - XGECOR 
CALLING PROCEDURES - NONE 
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PROCEDURE PROCLIB ( DGETUR ) 


♦♦♦♦PROCEDURE DGETUR 


PURPOSE - TO ALLOW EXECUTION OF THE TURBINE NOISE MODULE WITH 
DI-"'-'"ONAL INPUTS. USEFUL WHEN EXECUTION OF THE 
JE*. iSE PARAMETERS MODULE IS NOT DESIRED. 

AUTHOR - DSW(L03/00/00) 

WKB(L03/00/01) 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS MODULES 


NEN6 

RS 

AREA 


F 

HA 

NBLADE 

D 

VO 

ROTSPO 

TTI 

TSJ 

CA 

RHOA 

TA 

SCRXXX 

SCRNNN 

BROAD 


PURE 


NUMBER OF ENGINES (I) (DEFAULT*!) 

DISTANCE FROM SOURCE TO OBSERVER. 

(M),(FT) (RS) (DEFAULT*!. M) 

TURBINE INLET CROSS-SECTIONAL AREA 
(M^*2),(FT^^2) (RS) 

(DEFAULT*PI/4. M^*2) 

FUEL-TO-AIR RATIO (RS) (DEFAULT«0.) 
ABSOLUTE HUMIDITY, PERCENT MOLE FRACTION 
(RS) (DEFAULT*0.) 

NUMBER OF ROTOR BLADES (I) (DEFAULT*20) 
TURBINE ROTOR DIAMETER (M),(FT) (RS) 
(OEFAULT*SQRT(PI/4.) M) 

AIRCRAFT VELOCITY (M/S). (FT/S) (RS) 
(DEFAULT*0.) 

ROTATIONAL SPEED (RAD/S) (RS) 
(DEFAULT*!!5.2 RAD/S) 

ENTRANCE TOTAL TEMPERATURE (DEG K). 

(DEG R) (RS) (DEFAULT«!!52.6 DEG K) 

EXIT STATIC TEMPERATURE (DEG K). 

(DEG R) (RS) (DEFAULT=288.!5 DEG K) 
AMBIENT SPEED OF SOUND (M/S). (FT/S) 

(RS) (DEFAULT=340.294 M/S) 

AMBIENT DENSITY (KG/M**3) ,(SLUG/FT^^3) 
(RS) (DEFAULT*!. 225 K6/M^^3) 

AMBIENT TEMPERATURE (DEG K).(DE6 R) 

(RS) (DEFAULT*288.!5) 

THREE LETTER ID USED TO FORM TABLE NAME 
GETUR(XXXNNN) (A) (DEFAULT*3HXXX) 

VALUE USED TO FORM TABLE NAME 
GETUR(XXXNNN) (I) (DEFAULT*!) 

BROADBAND NOISE OPTION (L) 

.TRUE. COMPUTE BROADBAND NOISF (DEFAULT) 
.FALSE. DO NOT COMPUTE 
PURE TONE OPTION (L) 

.TRUE. COMPUTE PURE TONES (DEFAULT) 
.FALSE. DO NOT COMPUTE 


GETUR 
6ETUR 
IF.PARAM 
GETUR. PARAM 
IF. EVALUATE 

GETUR 
GETUR 

GETUR 

GETUR. PARAM 
IF. EVALUATE 
IF.PARAM 
EVALUATE 
GETUR. PARAM 
IF. EVALUATE 
GETUR. PARAM 
IF. EVALUATE 
GETUR. PARAM 
IF. EVALUATE 
GETUR .PARAM 
IF. EVALUATE 
GETUR. PARAM 
IF. EVALUATE 
IF.PARAM 
EVALUATE 
GETUR 

GETUR 

GETUR 


GETUR 
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PROCEDURE PROCLIB ( D6ETUR ) 


I OUT 


IPRINT 


lUNITS 


OUTPUT CODE FOR TABLE AND PRINTED OUTPUT 
(I) (DEFAULT=3) 

0 - NO PRINT BUT GENERATE GETUR(XXXNNN) . 
OUTPUT PRINT IN DB BUT NO TABLE. 
OUTPUT PRINT IN DIMENSIONLESS FORM 
BUT NO TABLE. 

OUTPUT PRINT IN DIMENSIONLESS FORM 
and DB BUT NO TABLE. 

OUTPUT PRINT IN OB AND GENERATE 
GETUR(XXXNNN). 

OUTPUT PRINT IN DIMENSIONLESS FORM 
AND GENERATE GETUR(XXXNNN). 

OUTPUT PRINT IN DIMENSIONLESS FORM 
AND DB AND GENERATE GETUR(XXXNNN). 
OUTPUT PRINT CODE (I) (DEFAULT=3) ‘ 

0 - NO PRINT 


-1 
-2 - 

•3 • 

1 - 

2 - 

3 - 


1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 
UNIT OPTION CODE (A) (DEFAULT=2HSI) 
2HSI - SI UNITS 

7HENGLISH - ENGLISH UNITS 


MEMBERS 

SFIELO(FREQ ) - ONE RECORD MEMBER OF THE VALUES 
, OF FREQUENCY IN HERTZ. 

SFIELD(THETA) - ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

SFIELO(PHI ) - ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 

OUTPUT 

USER PARAMETERS 


RS 

GETERR 


distance from SOURCE TO OBSERVER (M),(FT) 

ERROR PARAMETER (I) 

NO ERRORS ENCOUNTERED. 

MEMBER MANAGER ERROR OCCURRED ON OPE^ 
INSUFFICIENT LOS AVAILABLE. 

MEMBER MANAGER ERROR OCCURRED ON REAC 
AT LEAST ONE USER PARAMETER HAS AN 
INVALID VALUE. 

UNABLE TO BUILD TABLE GETUR(XXXNNN) . 
AN INVALID VALUE WAS CALCULATED DURIN 
EXECUTION. 


0 

1 

2 

3 

4 

5 

6 


GETUR 


GETUR 

IF, GETUR. 
PARAM 

MODULES 

GETUR 

GETUR 

GETUR 

MODULES 

GETUR 

GETUR 


PROCEDURE PROCLIB ( OGETUR ) 


MEMBERS 

GETUR(XXXNNN) - TYPE 1 DATA TABLE OF THE 

MEAN-SQUARE ACOUSTIC PRESSURE, 

LOCAL 

USER PARAMETERS 


MA 

AIRCRAFT MACH NUMBER (RS) 

AE 

ENGINE REFERENCE AREA (M**2) ,(FT**2) 
(RS) ’ 

TEMP 

5 ELEMENT PARAMETER FOR SAVING INPUT 
VALUES (RS) 

MEMBERS - 

NONE 

FUNCTIONS 



1. LOAD SFIELD DATA UNIT IF NOT ASSIGNED. 

DEFAULT VALUES OF USER PARAMETERS 

DEFINED, 

3, COMPUTE DIMENSIONLESS INPUTS TO MODULE GETUR. 

4. EXECUTE MODULE GETUR. 

MODULES CALLED - GETUR 
PROCEDURES CALLED - XGETUR 
CALLING PROCEDURES - NONE 


MODULES 

GETUR 


MODULES 

GETUR, 

EVALUATE 

PARAM.GETUR, 

EVALUATE 

PARAM, 

EVALUATE 


IF NOT 
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PROCEDURE PROCLIB ( DHDNFAN ) 


♦♦♦♦PROCEDURE DHDNFAN 

PURPOSE - TO ALLOW EXECUTION OF THE FAN NOISE MODULE WITH 
DIMENSIONAL INPUTS. USEFUL WHEN EXECUTION OF THE 
FAN NOISE PARAMETERS MODULE IS NOT DESIRED. 

AUTHOR - DSW(L03/00/00) 

WKB(L03/00/01) 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS MODULES 


RS 

AFAN 

DIAM 

MD 

RSS 

CH 

MDOT 

VO 

N 

DELTAT 

CA 

RHOA 

TA 

NBANDS 

NEN6 

NB 

NV 

IGV 


DISTANCE FROM SOURCE TO OBSERVER (M),(FT) 
(RS) (DEFAULT=1. M) 

FAN INLET CROSS-SECTIONAL AREA 
(M),(FT) (RS) (DEFAULT=1. M^^2) 

FAN ROTOR DIAMETER (M)»(FT) (RS) 
(DEFAULT-1. M) 

FAN ROTOR RELATIVE TIP MACH NUMBER AT 
DESIGN POINT (RS) (DEFAULT=1.) 
ROTOR-STATOR SPACING (M),(FT) (RS) 
(DEFAULT=0.01 M) 

MEAN ROTOR BLADE CHORD (M),(FT) (RS) 
(DEFAULT»0.01 M) 

MASS FLOW RATE (KG/S) .(SLUG/S) (RS) 
(DEFAULT«80 KG/S) 

AIRCRAFT VELOCITY (M/S). (FT/S) (RS) 
(DEFAULT*0.) 

ROTATIONAL SPEED (HZ) (RS) 

(DEFAULT=100.) 

TOTAL TEMPERATURE RISE ACROSS FAN 
(DEG K),(DEG R) (RS) 

(0EFAULT*60 DEG K) 

AMBIENT SPEED OF SOUND (M/S), (FT/S) 

(RS) (DEFAULT»340.294 M/S) 

AMBIENT DENSITY (KG/M^^3) ,(SLU6/FT^^3) 
(DEFAULT* 1.225 KG/M^^3) 

AMBIENT TEMPERATURE (DEG K),(DEG R) 
(DEFAULT»288.15 DEG K) 

NUMBER OF 1/3 OCTAVE BANDS FOR TONE 
FREQUENCY SHIFT (I) (DEFAULTED) 

NUMBER OF ENGINES (I) (DEFAULT*!) 


HDNFAN, 
IF.PARAM 
HDNFAN, PARAM, 
IF. EVALUATE 
HDNFAN.PARAM, 
IF, EVALUATE 
HDNFAN 

HDNFAN.PARAM, 
IF, EVALUATE 
EVALUATE, 
IF.PARAM 
HDNFAN.PARAM, 
IF, EVALUATE 
EVALUATE, 
IF.PARAM 
HDNFAN.PARAM, 
IF. EVALUATE 
HDNFAN.PARAM, 
IF. EVALUATE 


EVALUATE, 

IF.PARAM 

EVALUATE. 

IF.PARAM 

EVALUATE. 

IF.PARAM 

HDNFAN 


(RS) 


NUMBER OF ROTOR BLADES (I] 
NUMBER OF STATOR VANES (l 
INLET GUIDE VANE INDEX (I) 

1 - FOR A FAN WITHOUT IGV 

2 - FOR A FAN WITH IGV'S 


(0EFAULT*20) 

(0EFAULT»50) 

(DEFAULT*!) 


HDNFAN 

HDNFAN 

HDNFAN 

HDNFAN 
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PROCEDURE PROCLI8 ( DHDNFAN ) 


DIS 
I OUT 


IPRINT 


STIME 

SCRXXX 

SCRNNN 

lUNITS 


-1 

-2 


INLET FLOW DISTORTION INDEX (I) 

1 - NO INLET FLOW DISTORTION (DEFAULT) 

2 - INLET FLOW DISTORTED 

OUTPUT CODE FOR TABLE AND PRINTED OUTPUT 
(I) (DEFAULT-3) 

0 - NO PRINT BUT GENERATE HDNFAN(XXXNNN) . 
OUTPUT PRINT IN DB BUT NO TABLE. 
OUTPUT PRINT IN DIMENSIONLESS FORM 
BUT NO TABLE. 

OUTPUT PRINT IN DIMENSIONLESS FORM 
AND DB BUT NO TABLE. 

OUTPUT PRINT IN DB AND GENERATE 
HDNFAN(XXXNNN). 

OUTPUT PRINT IN DIMENSIONLESS FORM 
AND GENERATE HDNFAN(XXXNNN). 

OUTPUT PRINT IN DIMENSIONLESS FORM 
AND DB AN GENERATE HDNFAN(XXXNNN) . 
OUTPUT PRINT CODE (I) (DEFAULT»3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

SOURCE TIME AT WHICH NOISE IS CALCULATED 
(S) (RS) (DEFAULTED.) 

THREE LETTER ID USED TO FORM TABLE NAME 
HDNFAN(XXXNNN) (A) (DEFAULT»3HXXX) 

VALUE USED TO FORM TABLE NAME 
HDNFAN(XXXNNN) (I) (DEFAULT«1) 

UNIT OPTION CODE (A) (DEFAULT»2HSI) 

2HSI - SI UNITS 
7HENGLISH - ENGLISH UNITS 


■3 • 
1 . 


3 - 


HDNFAN 

HDNFAN 


HDNFAN 


HDNFAN 

HDNFAN 

HDNFAN 

HDNFAN 


(THE NEXT SIX PARAMETERS HAVE THE FOLLOWING VALUES (L) ) 

.TRUE. - INCLUDE IN TOTAL PREDICTION (DEFAULT)) 
( .FALSE. - DO NOT INCLUDE ! 


INRS 

INCT 

INDIS 

INBB 

IDRS 

IDBB 


INLET ROTOR STATOR INTERACTION TONES 

COMBINATION TONE NOISE 

INLET FLOW DISTORTION TONES 

INLET BROADBAND NOISE 

DISCHARGE ROTOR-STATOR INTERACTION TONE! 

DISCHARGE BROADBAND NOISE 


HDNFAN 

HDNFAN 

HDNFAN 

HDNFAN 

HDNFAN 

HDNFAN 


MEMBERS 


MODULES 


SFIELD(FREQ ) - ONE RECORD MEMBER OF THE VALUES HDNFAN 
OF FREQUENCY IN HERTZ. 

SFIELD(THETA) - ONE RECORD MEMBER OF THE VALUES HDNFAN 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 
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PROCEDURE PROCUB ( DHDNFAN ) 


SFIELD(PHI ) - ONE RECORD MEMBER OF THE VALUES HDNFAN 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 


OUTPUT 

USER PARAMETERS MODULES 

RS DISTANCE FROM SOURCE TO OBSERVER (M),(FT) HDNFAN 


MEMBERS MODULES 

HDNFAN(XXXNNN) - TYPE ONE DATA TABLE OF THE HDNFAN 

MEAN-SQUARE ACOUSTIC PRESSURE 

LOCAL 


USER PARAMETERS 

MODULES 

MA 

AIRCRAFT MACH NUMBER (RS) 

EVALUATE. 

HDNFAN 

AE 

ENGINE REFERENCE AREA (M**2) ,(FT**2) 

PARAM.HDNFAN 

TEMP 

(RS) 

EVALUATE 

6 ELEMENT PARAMETER FOR SAVING INPUT 

PAR AM, 


VALUES (RS) 

EVALUATE 

MEMBERS - 

NONE 



FUNCTIONS 


1. LOAD SFIELD UNIT IF NOT ASSIGNED. 

2. INITIALIZE DEFAULT VALUES OF USER PARAMETERS IF NOT 
DEFINED. 

3. COMPUTE DIMENSIONLESS INPUTS TO MODULE HDNFAN. 

4. EXECUTE MODULE HDNFAN. 

MODULES CALLED - HDNFAN 
PROCEDURES CALLED - XHDNFAN 
CALLING PROCEDURES . NONE 
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PROCEDURE PROCLIB { DSAESHK ) 


★♦♦★procedure DSAESHK 

PURPOSE - TO ALLOW EXECUTION OF THE CIRCULAR JET SHOCK CELL 
NOISE MODULE WITH DIMENSIONAL INPUi'S. USEFUL WHEN 
EXECUTION OF THE JET NOISE PARAMETERS MODULE IS NOT 
DESIRED. 

AUTHOR - DSW(L03/00/00) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS 


MODULES 


AJ 

VJ 

RHOJ 


TJ 

CA 

RHOA 

TA 

RS 

VO 

NSHK 

DELTA 

NENG 

SCRXXX 

SCRNNN 

ST I ME 

I OUT 


AREA OF THE JET (M**2) ,(FT**2) (RS) 
(DEFAULT=PI/4. M**2) 

FULLY EXPANDED JET VELOCITY (M/S), 
(FT/S) (RS) (DEFAULT»340.294 M/S) 


SAESHK,PARAM, 
IF, EVALUATE 
SAESHK,PARAM, 
IF. EVALUATE 


IF, EVALUATE 

SAESHK.PARAM, 
IF, EVALUATE 
SAESHK.PARAM, 
IF, EVALUATE 


FULLY EXPANDED JET DENSITY (KG/M**3), SAESHK.PARAM 
(SLUG/FT**3) (RS) 

(DEFAULT«0.6125 KG/M**3) 

JET TOTAL TEMPERATURE (DEG K),(DEG R) 

(RS) (DEFAULT=288.15 DEG K) 

AMBIENT SPEED OF SOUND (M/S), (FT/S) 

(RS) (DEFAULT=340.294 M/S) 

AMBIENT DENSITY (KG/M**3) ,(SLUG/FT**3) SAESHK.PARAM 

EVALUATE. 
IF.PARAM 
SAESHK, 
IF.PARAM 
EVALUATE, 
IF .PARAM 
SAESHK 
SAESHK 


(RS) (DEFAULT=1.225 KG/M**3) 

AMBIENT TEMPERATURE (DEG K),(DEG R) 

(RS) (DEFAULT=288.15 DEG K) 

RADIAL DISTANCE FROM NOZZLE EXIT TO 
OBSERVER (M),(FT) (RS) (DEFAULT*!. M) 
AIRCRAFT VELOCITY (M/S), (FT/S) (RS) 
(DEFAULTED.) 

NUMBER OF SHOCKS (I) (DEFAULT=8) 

ANGLE BETWEEN FLIGHT VECTOR AND ENGINE 
INLET AXIS (DEG) (RS) (DEFAULTED.) 

NUMBER OF ENGINES (I) (DEFAULT*!) 

THREE LETTER ID USED TO FORM TABLE NAME 
SAESHK(XXXNNN) (A) (OEFAULT*3HXXX) 

VALUE USED TO FORM TABLE NAME 
SAESHK(XXXNNN) (I) (DEFAULT*!) 

SOURCE TIME AT WHICH NOISE IS CALCULATED 
(S) (RS) (0EFAULT*0. S) 

OUTPUT CODE FOR TABLE AND PRINTED OUTPUT 
(I) (OEFAULT*3) 

0 - NO PRINT BUT GENERATE SAESHK( XXXNNN) . 
-! - OUTPUT PRINT IN DB BUT NO TABLE. 

-2 - OUTPUT PRINT IN DIMENSIONLESS FORM 
BUT NO TABLE. 


SAESHK 

SAESHK 

SAESHK 

SAESHK 

SAESHK 
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PROCEDURE PROCLIB ( DSAESHK ) 


IPRINT 


lUNITS 


MEMBERS 


-3 - OUTPUT PRINT IN DIMENSIONLESS FORM 
AND DB BUT NO TABLE. 

1 - OUTPUT PRINT IN DB AND GENERATE 

SAESHK(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE SAESHK(XXXNNN). 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND DB AND GENERATE SAESHK(XXXNNN) . 
OUTPUT PRINT CODE (I) (DEFAULT^ 3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 
UNIT OPTION CODE (A) (0EFAULT=2HSI) 

2HSI . SI UNITS 

7HEN6LISH - ENGLISH UNITS 


SFIELD(FREQ ) 
SFIELD(THETA ) 

SFIELO(PHI ) 


OUTPUT 

USER PARAMETERS 


ONE RECORD MEMBER OF THE VALUES 
OF FREQUENCY IN HERTZ. 

ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 


RS 

SAEERR 


RADIAL DISTANCE FROM NOZZLE EXIT TO 
OBSERVER (M),(FT) (RS) 

ERROR PARAMETER (I) 

0 - NO ERRORS ENCOUNTERED. 

1 - MEMBER MANAGER ERROR OCCURRED ON OPE 

2 - INSUFFICIENT LDS AVAILABLE. 

3 - MEMBER MANAGER ERROR OCCURRED ON REAI 

4 - AT LEAST ONE USER PARAMETER HAS AN 

INVALID VALUE. 

I “ SAESHK(XXXNNN), 

6 - AN INVALID VALUE WAS CALCULATED 
DURING EXECUTION. 


MEMBERS 


SAESHK(XXXNNN) 


TYPE 1 DATA TABLE OF THE 
MEAN-SQUARE ACOUSTIC PRESSURE. 


SAESHK 

SAESHK 

MODULES 

SAESHK 

SAESHK 

SAESHK 

MODULES 

SAESHK 

SAESHK 


MODULES 

SAESHK 
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PROCEDURE PROCUB ( DSAESHK ) 


LOCAL 

USER PARAMETERS 


MA 

AIRCRAFT MACH NUMBER (RS) 

AE 

ENGINE REFERENCE AREA (M**2) .(FT**2) 


(RS) 

TEMP 

4 ELEMENT PARAMETER FOR SAVING INPUT 


VALUES 

MEMBERS 

- NONE 

FUNCTIONS 



1. LOAD SFIELO DATA UNIT IF NOT ASSIGNED. 

2. INITIALIZE DEFAULT VALUES OF USER PARAMETERS 
DEFINED. 

3. COMPUTE DIMENSIONLESS INPUTS TO MODULE SAESHK 

4. EXECUTE MODULE SAESHK. 


MODULES 

EVALUATE , 
SAESHK 
EVALUATE , 
PAR AM. SAESHK 
PARAM, 
EVALUATE 


IF NOT 


MODULES CALLED - SAESHK 
PROCEDURES CALLED - XSAESHK 
CALLING PROCEDURES > NONE 


PROCEDURE PROCLIB ( DS6LJET ) 


♦♦♦♦PROCEDURE DS6UET 

PURPOSE - TO ALLOW EXECUTION OF THE SINGLE STREAM CIRCULAR JET 
NOISE MODULE WITH DIMENSIONAL INPUTS. USEFUL WHEN 
EXECUTION OF THE JET NOISE PARAMETERS MODULE IS NOT 
DESIRED. 

AUTHOR - DSW(L03/00/00) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS MODULES 


AJ 

RHOJ 

TJ 

VJ 

RS 

RHOA 

TA 

CA 

DELTA 

VO 

STIME 
SCRXXX 
SCRNNN 
I OUT 


AREA OF FULLY EXPANDED JET (M^^2), 
(FT^^2) (RS) (DEFAULT=PI/4. M^^2) 

DENSITY OF JET (KG/M*^3) ,(SLUG/FT^^3) 
(RS) (DEFAULT^ 1.225 KG/M**3) 

JET TOTAL TEMPERATURE (DEG K),(DEG R) 
(RS) (DEFAULT=288.15 DEG K) 

JET VELOCITY (M/S), (FT/S) (RS) 
(DEFAULT»340.294 M/S) 

RADIAL DISTANCE FROM NOZZLE EXIT TO 
OBSERVER (M),(FT) (RS) (DEFAULT^l. M) 
AMBIENT DENSITY (KG/M*^3) ,(SLUG/FT**3) 
(RS) (DEFAULT«1.225 KG/M**3) 

AMBIENT TEMPERATURE (DEG K),(DEG R) (RS) 
(DEFAULT=288.15 DEG K) 


SGLJET.PARAM, 
IF, EVALUATE 
SGLJET,PARAM, 
IF,EVALUATE 
SGLJET,PARAM, 
IF,EVALUATE 
SGLJET,PARAM, 
IF, EVALUATE 
SGLJET, 
IF,PARAM 
SGLJET,PARAM, 
IF, EVALUATE 
IF.PARAM, 
EVALUATE 


AMBIENT SPEED OF SOUND (M/S), (FT/S) (RS) SGLJET, PARAM 
(DEFAULT«340.294 M/S) IF, EVALUATE 

ANGLE BETWEEN FLIGHT DIRECTION AND ENGINE SGLJET 
INLET AXIS (DEGREES) (RS) (DEFAULT=0.) 

AIRCRAFT VELOCITY (M/S), (FT/S) (RS) IF,PARAM, 

(DEFAULT=0.) EVALUATE 

SOURCE TIME AT WHICH NOISE IS CALCULATED SGLJET 
(S) (RS) (DEFAULTED. S) 

THREE LETTER ID USED TO FORM TABLE NAME SGLJET 
SGLJET(XXXNNN). (A) (DEFAULT-3HXXX) 

VALUE USED TO FORM TABLE NAME SGLJET 

SGLJET(XXXNNN). (I) (OEFAULT-1) 

OUTPUT CODE FOR TABLE AND PRINTED OUTPUT SGLJET 
(I) (DEFAULT® 3) 

0 - NO PRINT BUT GENERATE SGLJET(XXXNNN) . 

■1 - OUTPUT PRINT IN DB BUT NO TABLE. 

.2 - OUTPUT PRINT IN DIMENSIONLESS FORM 
BUT NO TABLE. 


-3 - OUTPUT PRINT IN DIMENSIONLESS FORM AND 
DB BUT NO TABLE. 

1 - OUTPUT PRINT IN OB AND GENERATE 
SGLJET(XXXNNN). 
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PROCEDURE PROCLIB ( DS6',JET ) 


I PR I NT 


lUNITS 


NENG 


2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE SGLJET(XXXNNN) . 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND DB AND GENERATE SGLJET(XXXNNN) . 
OUTPUT PRINT CODE (I) (DEFAULT=3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 
UNIT OPTION CODE (A) (DEFAULT=2HSI) 

2HSI - SI UNITS 

7HENGLISH - ENGLISH UNITS 
NUMBER OF ENGINES (I) (DEFAULT=1) 


SGLJET 


SGLJET. 

IF.PARAM 

SGLJET 


MEMBERS 


MODULES 


SFIELD(FREQ 

) - 

SFIELO(THETA 

) - 

SFIELD(PHI 

) - 

SAE 

(OM 

) - 

SAE 

(PDF 

) • 

SAE 

(NDF 

) - 

SAE 

(MTH 

) - 

SAE 

(SCJ 

) - 

SAE 

(SCF 

) - 


OUTPUT 

USER PARAMETERS 


ONE RECORD MEMBER OF THE VALUES 
OF FREQUENCY IN HERTZ. 

ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 

TYPE 1 DATA TABLE OF THE JET 
VARIABLE DENSITY EXPONENT. 

TYPE 1 DATA TABLE OF THE POWER 
DEVIATION FACTOR. 

TYPE 1 DATA TABLE OF THE 
NORMALIZED DIRECTIVITY FUNCTION. 
TYPE 1 DATA TABLE OF THE FORWARD 
VELOCITY INDEX. 

TYPE 1 DATA TABLE OF THE 
SPECTRAL DISTRIBUTION FACTOR. 
TYPE 1 DATA TABLE OF THE 
STROUHAL NUMBER CORRECTION 
FACTOR. 


SGLJET 

SGLJET 

SGLJET 

SGLJET 

SGLJET 

SGLJET 

SGLJET 

SGLJET 

SGLJET 

MODULES 


RS RADIAL DISTANCE FROM NOZZLE EXIT TO SGLJET 

OBSERVER (M).(FT) (RS) 


MEMBERS 


MODULES 


SGLJET(XXXNNN) - TYPE 1 DATA TABLE OF THE SGLJET 

MEAN-SQUARE ACOUSTIC PRESSURE. 
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PROCEDURE PROCLIB ( DSGLJET ) 


LOCAL 


USER PARAMETERS 

MODULES 

MA 

AIRCRAFT MACH NUMBER (RS) 

SGLJET, 

EVALUATE 

AE 

ENGINE REFERENCE AREA (M**2) ,(FT**2) 

EVALUATE, 


(RS) 

PARAM, SGLJET 

TEMP 

4 ELEMENT PARAMETER FOR SAVING INPUT 

PARAM, 


VALUES (RS) 

EVALUATE 

MEMBERS 

- NONE 



FUNCTIONS 

1. LOAD SAE AND SFIELD DATA UNITS IF NOT ASSIGNED. 

2. INITIALIZE DEFAULT VALUES OF USER PARAMETERS IF NOT 
DEFINED. 

3. COMPUTE DIMENSIONLESS INPUTS TO MODULE SGLJET. 

4. EXECUTE MODULE SGLJET. 

MODULES CALLED - SGLJET 
PROCEDURES CALLED - XSGLJET 
CALLING PROCEDURES - NONE 
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PROCEDURE PROCLIB ( DSMBTUR ) 


****PROCEDURE DSMBTUR 


PURPOSE 


EXECUTION OF THE SMITH AND BUSHELL TURBINE 
DIMENSIONAL INPUTS, USEFUL WHEN 
DESIRED^*^ parameters MODULE IS NOT 


AUTHOR 


- DSW(L03/00/00) 
DSW(L03/00/05) 
MMF(L03/00/09 


INPUT 

USER PARAMETERS 


MODULES 


NENG 

RS 


AREA 


FA 

HA 


D 

MDOT 

VO 

N 

TSJ 

CA 

RHOA 

TA 


SMBTUR 
SMBTUR, 
IF.PARAM 
SMBTUR. PARAM, 
IF, EVALUATE 


SMBTUR 

SMBTUR 


SMBTUR .PARAM, 
IF.EVALUATE 


NS 

SCRXXX 


SCRNNN 


NUMBER OF ENGINES (I) (DEFAULT«1) 

DISTANCE FROM SOURCE TO OBSERVER 
(M).(FT) (RS) (DEFAULT«1. M) 

turbine inlet cross-sectional area 

(M**2),(FT**2) (RS) 

(DEFAULT=PI/4. M**2) 

(default*o.) 

ABSOLUTEfHUMIDITY. percent mole fraction 

ROTOR BLADE MEAN* AXIAL CHORD OF THE 
LAST STAGE (M).(FT) (RS) 

(0EFAULT«0.01 M) 

TURBINE ROTOR DIAMETER (M),(FT) (RS) 

(DEFAULT«1. M) v 

CORE MASS FLOW RATE (KG/S), (SLUG/S) 

(RS) (DEFAULT=65. KG/S) ^ 

(M/S).(FT/S) (RS) 

ROTATIONAL SPEED (RAD/S) (RS) 

(DEFAULT*115.2 RAD/S) 

EXIT STATIC TEMPERATURE (DEG K), 

(DEG R) (RS) (DEFAULT»288.15 DEG K) 

AMBIENT SPEED OF SOUND (M/S), (FT/S 
(RS) (DEFAULT»340,294 M/S) ir,tv«LUAit 

•(SI-US/FT**3)SM6TUR.PARMI. 

(RS) (DEFAULT®288«15) EVAIIiatp 

NUMBER OF STAGES (I) (DEFAULT®!) SbTUR 

THREE LETTER ID uko TO FORM TABLE NAME SMBTUR 
SMBTUR(XXXNNN) (A) (DEFAULT®3HXXX 
VALUE USED TO FORM TABLE NAME 
SMBTUR(XXXNNN) (I) (DEFAULT®!) 


IF, PARAM, 
EVALUATE 
SMBTUR.PARAM, 
IF.EVALUATE 
IF. PARAM, 
EVALUATE 
SMBTUR.PARAM, 
IF.EVALUATE 
SMBTUR.PARAM, 
IF.EVALUATE 
SMBTUR.PARAM, 
IF.EVALUATE 


SMBTUR 
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PROCEDURE PROCLIB ( DSMBTUR ) 


I OUT 


IPRINT 


lUNITS 


-1 

-2 

-3 

1 


?i[**(DEFAULT*^3^ TABLE AND PRINTED OUTPUT 

0 - NO PRINT BUT GENERATE SMBTUR(XXXNNN) , 
OUTPUT PRINT IN DB BUT NO TABLE, 
OUTPUT PRINT IN DIMENSIONLESS FORM 
BUT NO TABLE. 

OUTPUT PRINT IN DIMENSIONLESS FORM 
AND DB BUT NO TABLE. 

OUTPUT PRINT IN DB AND GENERATE 
SMBTUR(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE SMBTUR(XXXNNN) . 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND OB AND GENERATE SMBTUR(XXXNNN) . 
OUTPUT PRINT CODE (I) (DEFAULT»3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 
UNIT OPTION CODE (A) (DEFAULT»2HSI) 

2HSI - SI UNITS 

7HENGLISH - ENGLISH UNITS 


MEMBERS 


SFIELD(FREQ ) 
SFIELD(THETA) 


SFIELD(PHI ) 


- ONE RECORD MEMBER OF THE VALUES 
OF FREQUENCY IN HERTZ. 

- ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

- ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 


OUTPUT 

USER PARAMETERS 


RS 


DISTANCE FROM SOURCE TO OBSERVER (M).(FT) 


MEMBERS 

SMBTUR(XXXNNN) - TYPE 1 DATA TABLE OF THE 

MEAN-SQUARE ACOUSTIC PRESSURE. 


SMBTUR 


SMBTUR 

IF, SMBTUR. 
PARAM 

MODULES 

SMBTUR 

SMBTUR 

SMBTUR 

MODULES 

SMBTUR 

MODULES 

SMBTUR 
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PROCEDURE PROCLIB ( DSMBTUR ) 


LOCAL 

USER PARAMETERS 


MODULES 


MA 

AE 

TEMP 


AIRCRAFT MACH NUMBER (RS) 

ENGINE REFERENCE AREA (M**2) ,(FT**2) 

5 ELEMENT PARAMETER FOR "AVING INPUT 
VALUES (RS) 


SMBTUR» 

EVALUATE 

PARAM»SMBTUR, 

EVALUATE 

PARAM» 

EVALUATE 


MEMBERS - NONE 


FUNCTIONS 


1. LOAD SFIELD DATA UNIT IF NOT ASSIGNED. 

default values of USER PARAMETERS IF NOT 

UlFINED» 

3. COMPUTE DIMENSIONLESS INPUTS TO MODULE SMBTUR 

4. EXECUTE MODULE SMBTUR. 

MODULES CALLED - SMBTUR 


PROCEDURES CALLED - XSMBTUR 


CALLING PROCEDURES - NONE 


5-33 


PROCEDURE PROCLIB ( DSTNJET ) 


★♦♦♦PROCEDURE DSTNJET 


PURPOSE - TO ALLOW EXECUTION OF THE STONE JET NOISE MODULE WITH 
DIMENSIONAL INPUTS. USEFUL WHEN EXECUTION OF THE JET 
NOISE PARAMETERS MODULE IS NOT DESIRED. 

AUTHOR - DSW(L03/00/05) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS MODULES 


CA 

RHOA 

TA 

VO 

DELTA 

RS 

NENG 

A1 

DEI 

DHl 

VI 

RHOl 


T1 

A2 

V2 

RH02 


T2 


STIME 


AMBIENT SPEED OF SOUND (M/S). (FT/S) 
(RS) (DEFAULT*340.294 M/S) 

AMBIENT DENSITY (KG/M^^3) ,(SLUG/FT*^3) 
(RS) (DEFAULT»1.225 KG/M^^3) 

AMBIENT TEMPERATURE (DEG K),(DEG R) 
(RS) (0EFAULT»288.15 DEG K 
AIRCRAFT VELOCITY (M/S), (FT/S) (RS) 
(DEFAULTED.) 

ANGLE BETWEEN FLIGHT VECTOR AND ENGINE 
INLET AXIS (DEGREES) (RS) (DEFAULTED.) 
DISTANCE FROM NOZZLE EXIT TO OBSERVER 
(M).(FT) (RS) (DEFAULT*!. M) 

NUMBER OF ENGINES (I) (DEFAULT*!) 
PRIMARY JET AREA (M^^2) ,(FT^^2) (RS) 
(DEFAULT*PI/4. M*^2) 

PRIMARY STREAM EQUIVALENT DIAMETER 
(M).(FT) (RS) (DEFAULT*!. M) 

PRIMARY STREAM HYDRAULIC DIAMETER 
(M).(FT) (RS) (DEFAULT*!. M) 

PRIMARY JET VELOCITY (M/S), (FT/S) (RS) 
(DEFAULT*340.294 M/S) 

PRIMARY JET DENSITY (KG/M^*3), 
(SLUG/FT^^3) (RS) 

(DEFAULT*!. 225 K6/M^^3) 

PRIMARY JET TOTAL TEMPERATURE (DEG K) , 
(DEG R) (RS) (DEFAULT*288.!5 DEG K) 
SECONDARY JET AREA (M^^2) ,(FT^^2) (RS) 
(DEFAULT*0.) 

SECONDARY JET VELOCITY (M/S) (FT/S) 

(RS) (DEFAULT*0.) 

SECONDARY JET DENSITY (KG/M^^3), 
(SLUG/FT^^3) (RS) 

(DEFAULT*!. 225 KG/M^*3) 

SECONDARY JET TOTAL TEMPERATURE 


(DEG K),(OEG R) (RS) 
(DEFAULT*288.!5 DEG K) 

SOURCE TIME AT WHICH NOISE IS 
CALCULATED (S) (DEFAULT*0.) 


IF, EVALUATE. 
STNJET.PARAM 
IF. EVALUATE. 
STNJET.PARAM 
IF.PARAM. 
EVALUATE 
IF.PARAM. 
EVALUATE 
STNJET 

IF.PARAM. 
STNJET 
STNJET 
IF. EVALUATE. 
STNJET.PARAM 
IF. EVALUATE. 
STNJET.PARAM 
IF. EVALUATE. 
STNJET.PARAM 
IF. EVALUATE. 
STNJET.PARAM 
IF. EVALUATE. 
STNJET.PARAM 

IF.EVALUATE. 

STNJET.PARAM 

IF.EVALUATE. 

STNJET.PARAM 

IF.EVALUATE. 

STNJET.PARAM 

IF.EVALUATE. 

STNJET.PARAM 

IF.EVALUATE. 

STNJET.PARAM 

STNJET 
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PROCEDURE PROCLIB ( DSTNJET ) 


SCRXXX THREE LETTER ID USED TO FORM TABLE NAME 
STNJET(XXXNNN) (A) (DEFAULT=3HXXX) 

SCRNNN VALUE USED TO FORM TABLE NAME 
STNJET(XXXNNN) (I) (DEFAULT=1) 

I OUT OUTPUT CODE FOR TABLE AND PRINTED OUTPUT 

(I) (DEFAULT«3) 

0 - NO PRINT BUT GENERATE STNJET(XXXNNN) . 
-1 - OUTPUT PRINT IN DB BUT NO TABLE. 

-2 - OUTPUT PRINT IN DIMENSIONLESS FORM 
BUT NO TABLE. 

-3 - OUTPUT PRINT IN DIMENSIONLESS FORM 
AND DB BUT NO TABLE. 

1 - OUTPUT PRINT IN DB AND GENERATE 

STNJET(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE STNJET(XXXNNN) . 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND DB AND GENERATE STNJET(XXXNNN) . 

I PRINT OUTPUT PRINT CODE (I) (DEFAULT»3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

lUNITS UNIT OPTION CODE (A) (DEFAULT=2HSI) I 
2HSI - SI UNITS 
7HENGLISH - ENGLISH UNITS 
PLUG NOZZLE PLUG OPTION (L) (DEFAULT-. FALSE.) 
.TRUE. - CONICAL PLUG NOZZLE 
.FALSE. - NO NOZZLE PLUG 

CIRCLE NOZZLE TYPE OPTION (L) (DEFAULT-. FALSE.) 
.TRUE. - CIRCULAR NOZZLE 
.FALSE. - COAXIAL NOZZLE 

SUPER SHOCK NOISE OPTION (L) (DEFAULT-. FALSE.) 
.TRUE. - COMPUTE SHOCK NOISE FOR 
PRIMARY STREAM 

.FALSE. - DO NOT COMPUTE SHOCK NOISE 

MEMBERS 

SFIELD (FREQ ) - ONE RECORD MEMBER OF THE VALUES 
OF FREQUENCY IN HERTZ. 

SFIELD (THETA) - ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

SFIELD (PHI ) - ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 

STNTBL (JOF ) - TYPE 1 DATA TABLE OF THE JET 
MIXING NOISE SPECTRAL 
DISTRIBUTION FACTOR. 


STNJET 

STNJET 

STNJET 


STNJET 

, PAR AM, 
STNJET 

STNJET 

STNJET 

STNoST 

MODULES 

STNJET 

STNJET 

STNJET 

STNJET 
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PROCEDURE PROCLIB ( DSTNJET ) 




STNTBL (SDF ) - TYPE^l DATA TABLE OF THE SHOCK 

STNTBL (FSP ) - TYPE 1 DATA TABLE OF THE 
FREQUENCY SHIFT PARAMETER. 


STNJET 

STNJET 


OUTPUT 

USER PARAMETERS 


MODULES 


RS SOURCE TO OBSERVER (M),(FT) STNJET 


MEMBERS 


MODULES 


STNJET(XXXNNN) - TYPE 1 DATA TABLE OF THE 

MEAN-SQUARE ACOUSTIC PRESSURE. 


STNJET 


LOCAL 

USER PARAMETERS 


MEMBERS 


MA 

AIRCRAFT MACH NUMBER (RS) 

Ml 

PRIMARY JET MACH NUMBER (RS) 

M2 

SECONDARY JET MACH NUMBER (RS) 

AE 

TEMP 

(RS)*'*^ I^^PERENCE area (M*’*2) .(FT**2) 

valuemrV^^^'^^^^'^ por saving input 

MEMBERS - 

NONE 

functions 



STNJET. 

EVALUATE 

STNJET. 

EVALUATE 

STNJET. 

EVALUATE 

EVALUATE. 

STNJET.PARAM 

EVALUATE. 

PARAM 


1 . 

2 . 

3. 

4. 


LOAD SFIELD AND STNTBL DATA UNITS IF NOT AS^Tf'WFn 

initialize default values of U^R RARASETERl'f^'SiT 


MODULES CALLED - STNJET 


PROCEDURES CALLED - XSTNJET 
CALLING PROCEDURES - NONE 
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PROCEDURE PROCUB ( ICA078 ) 


31 


♦♦♦♦PROCEDURE ICA078 

PURPOSE - TO LOAD THE UNIT MEMBERS AND SET THE PARAMETERS 

REQUIRED TO IMPLEMENT THE ICAO REFERENCE PROCEDURE. 

AUTHOR - DSW(L03/00/05) 

INPUT - NONE 

OUTPUT 


USER PARAMETERS 

MODULES 

ICA078 

LOGICAL PARAMETER TO IMPLEMENT ICAO 

PARAM 

SAE 

PROCEDURE METHODS IN NOISE MODULES 
(».TRUE.) 

LOGICAL PARAMETER TO REQUEST SAE 

PARAM 

MEMBERS 

ATMOSPHERIC ABSORPTION METHOD(*.TRUE.) 


SAE(OM ) 
SAE(PDF) 
SAE(NDF) 
SAE(MTH) 
SAE(SJC) 
SAE(SCF) 


TYPE 1 DATA TABLES WITH ICAO REVISIONS 
REQUIRED FOR SINGLE STREAM CIRCULAR 
JET NOISE MODULE (SGLJET) 


LOAD 


LOCAL - NONE 


MODULES CALLED - NONE 
PROCEDURES CALLED - NONE 
CALLING PROCEDURES - NONE 
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PROCEDURE PROCLIB ( LI STALL ) 


♦♦★♦procedure LI stall 

PURPOSE - TO PROVIDE A LISTING OF ALL, PROCEDURE MEMBERS IN THE 
PROCEDURE LIBRARY. 

AUTHOR - DSW(L03/00/00) 

INPUT - NONE 

OUTPUT - NONE 

LOCAL - NONE 

FUNCTION 

1. PROVIDE LISTING OF PROCEDURE LIBRARY USING MEMLIST 
CONTROL STATEMENTS. 

MODULES CALLED - NONE 

PROCEDURES CALLED - NONE 

CALLING PROCEDURES - NONE 
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PROCEDURE PROCLIB ( LI STONE ) 


**** PROCEDURE LI STONE 

PURPOSE - TO PROVIDE A LISTING OF A SINGLE PROCEDURE MEMBER 
IN THE PROCEDURE LIBRARY. 

AUTHOR - DSW(L03/00/00) 

INPUT 

USER PARAMETERS - NONE 

MEMBERS MODULES 

PROCLIB(PROC) PROCEDURE MEMBER TO BE LISTED. MEMLIST 
OUTPUT - NONE 
LOCAL . NONE 
FUNCTION 

1. PROVIDE LISTING OF A USER SPECIFIED PROCEDURE LIBRARY 
MEMBER USING A MEMLIST CONTROL STATEMENT. 

MODULES CALLED - NONE 

PROCEDURES CALLED - NONE 

CALLING PROCEDURES - NONE 
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PROCEDURE PROCLIB ( PROHUL ) 


i 


♦♦♦♦PROCEDURE PROMUl. 

PURPOSE - TO PROPAGATE A SET OF NOISE SOURCES AND THEIR SUM 
IN THE SAME COORDINATE SYSTEM TO AN ARRAY 
OF OBSERVERS ANU COMPUTE NOISE SPECTRA, NOISE 
LEVELS, AND EFFECTIVE PERCEIVED NOISE LEVELS AT THE 
OBSERVER. 

AUTHOR - DSW(L03/00/00) 

WKB(Ln.VOO/01) 

DSW(L03/00/05) 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS MODULES 

NCOMP NUMBER OF NOISE COMPONENTS TO BE IF,PARAM 

PROPAGATED (I) (DEFAULT»2) 

PROPRT PRINT OPTION CODE FOR PRO MODULE (I) PRO 

*0 NO PRINTED OUTPUT 
=1 PRINT INPUT DATA ONLY 
=2 PRINT OUTPUT DATA ONLY 
*3 PRINT INPUT AND OUTPUT DATA (DEFAULT) 
lOUT OUTPUT OPTION CODE (I) PRO 

=1 PRINT OUTPUT AS SOUND PRESSURE 
LEVEL, SPL, IN DECIBELS 
=2 PRINT OUTPUT AS DIMENSIONLESS 
MEAN-SQUARE PRESSURE (DEFAULT) 

»3 PRINT OUTPUT IN BOTH FORMS 
SIGMA SPECIFIC FLOW RESISTANCE OF THE GROUND PRO 

(KG/(S M^^3)).(SLU6/(S FT^^3)) (RS) 

(DEFAULT=2.5E5 KG/(S M^^3)) 

lUNITS UNITS OPTION CODE (A) (DEFAULT»2HSI) PRO,LEV 
=2HSI INPUTS ARE IN SI UNITS 
=7HENGLISH INPUTS ARE IN ENGLISH UNITS 
NBAND NUMBER OF SUBBANDS PER ONE-THIRD OCTAVE PRO 
BAND AS SPECIFIED FOR GRA (I) (DEFAULT=5) 

RS SOURCE RADIUS (M),(FT) (RS) (DEFAULT=1M) PRO 
SURFACE TYPE OF SURFACE TO BE USED IN COMPUTING PRO 
CHIEN-SOROKA GROUND EFFECTS 
»4HS0FT SOFT GROUND SURFACE (DEFAULT) 

»4HHARD HARD GROUND SURFACE 

ABSORP ATMOSPHERIC ABSORPTION OPTION (L) PRO 

".TRUE. INCLUDE ABSORPTION EFFECTS 
=. FALSE, no NOT INCLUDE (DEFAULT) 

GROUND GROUND EFFECTS OPTION (L) PRO 

».TRUE. INCLUDE CHIEN-SOROKA GROUND 
EFFECTS 

». FALSE. DO NOT INCLUDE (DEFAULT) 
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PROTIME THREE LETTER ID (XXX) TO APPEND TO 3HFLI PRO 
TO DEFINE THE UNIT MEMBER FLI(FLIXXX) AND 
THE NOISE DATA UNIT MEMBER YYYYYY(XXXNNN) . 
(DEFAULT»3HXXX) 

PROSUM CONTAINS THE NAMES OF THE NOISE UNITS PRO 
TO BE INDIVIDUALLY PROPAGATED AND SUMMED 
AND PROPAGATED TO THE OBSERVER. 

(DEFAULT«6HYYYYYY) 

lAWT A-WEIGHTED SOUND PRESSURE LEVEL OPTION (L) LEV. 

-.TRUE. COMPUTE A-WEIGHTED SPL IF .PARAM 

-.FALSE. DO NOT COMPUTE (DEFAULT) 
lOWT D-WEIGHTED SOUND PRESSURE LEVEL OPTION (L) LEV. 

-.TRUE. COMPUTE D-WEIGHTED SPL IF, PARAM 

-.FALSE. DO NOT COMPUTE (DEFAULT) 
lOSPL OVERALL SOUND PRESSURE LEVEL OPTION (L) LEV, 

-.TRUE. COMPUTE OASPL IF, PARAM 

-.FALSE. DO NOT COMPUTE (DEFAULT) 

IPNL PERCEIVED NOISE LEVEL OPTION (L) LEV. 

-.TRUE. COMPUTE PNL IF, PARAM 

-.FALSE. DO NOT COMPUTE (DEFAULT) 

IPNLT TONE CORRECTED PERCEIVED NOISE LEVEL LEV, 

OPTION (L) IF, PARAM 

-.TRUE. COMPUTE PNLT (DEFAULT) 

-.FALSE. DO NOT COMPUTE 

LEVPRT PRINT OPTION CODE FOR LEV MODULE (I) LEV 

=0 NO PRINTED OUTPUT 
-1 PRINT INPUT DATA ONLY 
-2 PRINT OUTPUT DATA ONLY 
-3 PRINT INPUT AND OUTPUT DATA (DEFAULT) 
lEPNL EFFECTIVE PERCEIVED NOISE LEVEL OPTION (L) IF, 

-.TRUE. COMPUTE EPNL (DEFAULT) PARAM 

-.FALSE. DO NOT COMPUTE 

OTIME RECEPTION TIME INCREMENT (S) (RS) EFF 

(DEFAULT-0. 5) 

EFFPRT PRINT OPTION CODE FOR EFF MODULE (I) EFF 

-0 NO PRINTED OUTPUT 
-1 PRINT INPUT DATA ONLY 
-2 PRINT OUTPUT DATA ONLY 
-3 PRINT INPUT AND OUTPUT DATA (DEFAULT) 

MEMBERS MODULES 

ATM (TMOD ) TYPE 1 TABLE OF ATMOSPHERIC DATA. PRO 

ATM (AAC ) TYPE 1 TABLE OF ATMOSPHERIC PRO 

ABSORPTION DATA. 

GEO (GEOM ) MULTI-RECORD MEMBER OF GEOMETRY PRO 

DATA. 

FLI (FLIXXX) MULTI-RECORD MEMBER OF FLIGHT DATA. PRO 
XXX IS DEFINED BY THE PROTIME 
PARAMETER. 
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YYYYYY(XXXNNN) TYPE 1 TABLE OF MEAN-SQUARE PRO 

ACOUSTIC PRESSURE. YYYYYY IS NOISE 
MODULE(S) DEFINED BY PROSUM AND 
NNN IS THE SOURCE TIME NUMBER. 
OBSERV(COORD ) MULTI-RECORD MEMBER OF OBSERVER LEV.EFF 
COORDINATES. 

SFIELO(FREQ ) ONE RECORD MEMBER OF THE VALVES LEV 
OF FREQUENCY IN HERTZ. 

OUTPUT 

USER PARAMETERS - NONE 

MEMBERS MODULES 

PRO (PRES ) MULTI-RECORD MEMBER OF THE MEAN- PRO 
SQUARE ACOUSTIC PRESSURE AT THE 
OBSERVERS. 

(NOTE: OVERRIDE OF THIS NAME ON 
THE CALL CONTROL STATEMENT MUST 
BE DONE AS: 

PRO=NEWNAM£ PRES=NEWNAME 
6HPR0 =6HNEWNAM 6HPRES = 

6HNEWNAM 


TO CORRECTLY CHANGE UNIT MEMBER 
NAME AND VAHtE OF LOCAL 
PARAMETER MEMSUM) 

LEV (PNLT ) MULTI -RECORD MEMBER OF PNLT AT LEV 

THE OBSERVERS. 

EFF (EPNL ) MULTI-RECORD MEMBER OF EPNL AT EFF 

THE OBSERVERS. 

LOCAL 

USER PARAMETERS MODULES 

MEMSUM UNIT MEMBER NAME OF LEV INPUT MEMBER, LEV 
HAS VALUE 6HPR0 6HPRES . 


MEMBERS 


MODULES 


SCRATCH! XXXNNN) MEMBER CONTAINING RESULT OF NOISE 
TABLE SUMMING. 


FUNCTIONS 


PRO 


1. CALL PROCLIB(XPROSGL) TO PROPAGATE SUM OF NOISE SOURCES 
TO OBSERVERS. 

2. INITIALIZE LOUP TO PROPAGATE INDIVIDUAL NOISE SOURCES. 

3. CALL PROCLIB(XPROSGL) TO PROPAGATE INDIVIDUAL NOISE 
SOURCES TO THE OBSERVERS. 
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MODULES CALLED - EFF LEV PRO 

PROCEDURES CALLED - PROSGL XEFF XLEV XPRO XPROSGL 

CALLING PROCEDURES - NONE 
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PROCEDURE PROCLIB ( PR0S6L ) 


♦♦♦•procedure PROSGL 

PURPOSE - TO PROPAGATE A SINGLE NOISE SOURCE OR ONE SUM OF 
NOISE SOURCES IN THE SAME COORDINATE SYSTEM TO AN 
ARRAY OF OBSERVERS AND COMPUTE NOISE SPECTRA, NOISE 
LEVELS, AND EFFECTIVE PERCEIVED NOISE LEVELS AT THE 
OBSERVER. 

AUTHOR - DSW(L03/00/00) 

WKB(L03/00/01) 

DSW(L03/00/05) 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS MODULES 

PROPRT PRINT OPTION CODE FOR PRO MODULE (I) PRO 

»0 NO PRINTED OUTPUT 
=1 PRINT INPUT DATA ONLY 
=2 PRINT OUTPUT DATA ONLY 
=3 PRINT INPUT AND OUTPUT DATA (DEFAULT) 
lOUT OUTPUT OPTION CODE (i) PRO 

=1 PRINT OUTPUT AS SOUND PRESSURE 
LEVEL, SPL, IN DECIBELS 
*2 PRINT OUTPUT AS DIMENSIONLESS 
MEAN-SQUARE PRESSURE (DEFAULT) 

*3 PRINT OUTPUT IN BOTH FORMS 
SIGMA SPECIFIC FLOW RESISTANCE OF THE GROUND PRO 

(KG/(S M**3)),(SLU6/(S FT**3)) (RS) 
(DEFAULT=2.5E5 KG/(S M**3)) 

lUNITS UNITS OPTION CODE (A) 1DEFAULT»2HSI) PRO, LEV 
=2HSI INPUTS ARE IN SI UNITS 
=7HENGLISH INPUTS ARE IN ENGLISH UNITS 
NBAND NUMBER OF SUBBANDS PER ONE-THIRD OCTAVE PRO 
BAND AS SPECIFIED FOR GRA (I) (DEFAULT=5) 

RS SOURCE RADIUS (M),(FT) (RS) (DEFAULT«1M) PRO 
SURFACE TYPE OF SURFACE TO BE USED IN COMPUTING PRO 
CHIEN-SOROKA GROUND EFi-ECTS 
=4HS0FT SOFT GROUND SURFACE (DEFAULT) 

=4HHARD HARD GROUND SURFACE 

ABSORP ATMOSPHERIC ABSORPTION OPTION (L) PRO 

=.TRUE. INCLUDE ABSORPTION EFFECTS 
=. FALSE. DO NOT INCLUDE (DEFAULT) 

GROUND GROUND EFFECTS OPTION (L) PRO 

«.TRUE. INCLUDE CHIEN-SOROKA GROUND 
EFFECTS 

=. FALSE. DO NOT INCLUDE (DEFAULT) 
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PROCEDURE PROCLIB ( PROSGL ) 


I 


PROTIME THREE LETTER ID (XXX) TO APPEND TO 3HFLI PRO 
TO DEFINE THE UNIT MEMBER FLI(FUXXX) AND 
THE NOISE DATA UNIT MEMBER YYYYYY(XXXNNN). 
(DEFAULT«3HXXX) 

PROSUM CONTAINS THE NAME(S) OF THE NOISE UNIT(S) PRO 
TO BE SUMMED (IF MORE THAN ONE ) 

AND PROPAGATED TO THE OBSERVER. 

(0EFAULT»6HYYYYYY) 

lAWT A-WEIGHTEO SOUND PRESSURE LEVEL OPTION (L) LEV. 

-.TRUE. COMPUTE A-WEI6HTED SPL IF.PARAM 

-.FALSE. DO NOT COMPUTE (DEFAULT) 

IDWT 0-WEIGHTED SOUND PRESSURE LEVEL OPTION (L) LEV. 

-.TRUE. COMPUTE D-WEIGHTED SPL IF.PARAM 

-.FALSE. DO NOT COMPUTE (DEFAULT) 
lOSPL OVERALL SOUND PRESSURE LEVEL OPTION (L) LEV. 

-.TRUE. COMPUTE OASPL IF.PARAM 

-.FALSE. DO NOT COMPUTE (DEFAULT) 

IPNL PERCEIVED NOISE LEVEL OPTION (L) LEV. 

-.TRUE. COMPUTE PNL IF.PARAM 

-.FALSE. DO NOT COMPUTE (DEFAULT) 

IPNLT TONE CORRECTED PERCEIVED NOISE LEVEL LEV. 

OPTION (L) IF.PARAM 

-.TRUE. COMPUTE PNLT (DEFAULT) 

-.FALSE. DO NOT COMPUTE 

LEVPRT PRINT OPTION CODE FOR LEV MODULE (I) LEV 

-0 NO PRINTED OUTPUT 
-1 PRINT INPUT DATA ONLY 
-2 PRINT OUTPUT DATA ONLY 
-3 PRINT INPUT AND OUTPUT DATA (DEFAULT) 


lEPNL 

EFFECTIVE PERCEIVED NOISE LEVEL OPTION (L) 
-.TRUE. COMPUTE EPNL (DEFAULT) 

-.FALSE. DO NOT COMPUTE 

IF. 

PARAM 

OTIME 

RECEPTION TIME INCREMENT (S) (RS) 
(DEFAULT-0. 5) 

EFF 

EFFPRT 

PRINT OPTION CODE FOR EFF MODULE (I) 
-0 NO PRINTED OUTPUT 
-1 PRINT INPUT DATA ONLY 
-2 PRINT OUTPUT DATA ONLY 

EFF 


=3 PRINT INPUT AND OUTPUT DATA (DEFAULT) 


MEMBERS 



MODULES 

ATM 

(TMOD 

) TYPE 1 TABLE OF ATMOSPHERIC DATA. 

PRO 

ATM 

(AAC 

) TYPE 1 TABLE OF ATMOSPHERIC 
ABSORPTION DATA. 

PRO 

GEO 

(GEOM 

) MULTI-RECORD MEMBER OF GEOMETRY 
DATA. 

PRO 
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FLI (FLIXXX) MULTI-RECORD MEMBER OF FLIGHT DATA. PRO 
XXX IS DEFINED BY THE PROTIME 
PARAMETER. 

YYYYYY(XXXNNN) TYPE 1 TABLE OF MEAN-SQUARE PRO 

ACOUSTIC PRESSURE. YYYYYY IS NOISE 


MODULE (S) DEFINED BY PROSUM AND 
NNN IS THE SOURCE TIME NUMBER. 

OBSERV(COORD ) MULTI-RECORD MEMBER OF OBSERVER LEV.EFF 
COORDINATES. 

SFIELD(FREQ ) ONE RECORD MEMBER OF THE VALVES LEV 

OF FREQUENCY IN HERTZ. ■ 

OUTPUT 

USER PARAMETERS - NONE i 

! 

MEMBERS MODULES 

PRO (PRES ) MULTI-RECORD MEMBER OF THE MEAN- PRO j 


SQUARE ACOUSTIC PRESSURE AT THE 
OBSERVERS. 

(NOTE: OVERRIDE OF THIS NAME ON 
THE CALL CONTROL STATEMENT MUST 
BE DONE AS: 

PRO=NEWNAME PRES*NEWNAME 
6HPR0 =6HNEWNAM 6HPRES = 

6HNEWNAM 

TO CORRECTLY CHANGE UNIT MEMBER 
NAME AND VALUE OF LOCAL 
PARAMETER MEMSUM) 

MULTI-RECORD MEMBER OF PNLT AT LEV 
THE OBSERVERS. 

MULTI-RECORD MEMBER OF EPNL AT EFF 
THE OBSERVERS. 

MODULES 

MEMSUM UNIT MEMBER NAME OF LEV INPUT MEMBER, LEV 
HAS VALUE 6HPR0 6HPRES . 

MEMBERS MODULES 

SCRATCH (XXXNNN) MEMBER CONTAINING RESULT OF NOISE PRO 
TABLE SUMMING. 


LEV (PNLT ) 

EFF (EPNL ) 

LOCAL 

USER PARAMETERS 
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FUNCTIONS 


1 . 

2 . 

3 . 

4 . 


LOAD SFIELD UNIT IF NOT ASSIGNED. 

EXECUTE PRO MODULE. 

EXeSte fee USmt OESIREO. 

tXtCUTE EFF MODULE IF EPNL IS DESIRED. 


MODULES CALLED - EFF LEV PRO 


PROCEDURES CALLED - XEFF XLEV XPRO 
CALLING PROCEDURES - XPROSGL 
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•‘♦♦PROCEDURE SOLO I R 

PURPOSE - rO CONVERT A STANDARD TYPE 1 NOISE TABLE FROM POLAR 
DIRECTIVITY ANGLES TO SIDELINE DIRECTIVITY ANGLES. 

A TABLE IN THIS FORM IS USEFUL FOR COMPARISONS TO 
EXPERIMENTAL DATA WITH PROPAGATION EFFECTS REMOVED. 

AUTHOR - nSW(L03/00/05) 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS MODULES 

SCRXXX THREE LETTER ID USED TO FORM TABLE NAMES GENSUP 
NOISE (XXXNNN) AND NOISES(XXXNNN) (A) 
(DEFAULT=3HXXX) 

SCRNNN VALUE USED TO FORM TABLE NAMES GENSUP 

NOISE(XXXNNN) AND NOISES(XXXNNN) (I) 

(DEFAULT=1) 

IPRINT OUTPUT PRINT CODE (I) (DEFAULT-3) GENSUP 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

RHOA AMBIENT DENSITY (KG/M“3) .(SLUG/FT‘*3) GENSUP 

(RS) (DEFAULT- 1.225 KG/M‘*3) 

CA AMBIENT SPEED OF SOUND (M/S), (FT/S) GENSUP 

(RS) (OEFAULT-340.294 M/S) 

I OUT OUTPUT CODE FOR TABLE AND PRINTED OUTPUT GENSUP 

(I) (DEFAULT- 3) 

0 - NO PRINT BUT GENERATE NOISES(XXXNNN). 

-1 - OUTPUT PRINT IN DB BUT NO TABLE. 

-2 - OUTPUT PRINT IN DIMENSIONLESS FORM 
BUT NO TABLE. 

-3 - OUTPUT PRINT IN DIMENSIONLESS FORM 
AND DB BUT NO TABLE. 

1 - OUTPUT PRINT IN DB AND GENERATE 

NOISES(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE NOISES(XXXNNN) . 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND DB AND GENERATE NOISES(XXXNNN) . 
lUNITS UNIT OPTION CODE (A) (OEFAULT-2HSI) GENSUP 

2HSI - SI UNITS 
7HENGLISH - ENGLISH UNITS 



MEMBERS 


PROCEDURE PROCLIB ( SDLDIR ) 


NOISE (XXXNNN) - TYPE 1 DATA TABLE OF THE MEAN- 
SQUARE ACOUSTIC PRESSURE AS 
PREDICTED BY ANY NOISE MODULE, 


OUTPUT 

USER PARAMETERS - NONE 


MODULES 

6ENSUP 


MEMBERS 

NOISES(XXXNN) - TYPE 1 DATA TABLE OF THE MEAN- 
SQUARE ACOUSTIC PRESSURE IN 
TERMS OF SIDELINE DIRECTIVITY. 

LOCAL 

USER PARAMETERS - NONE 


MODULES 


MEMBERS 
SOL (DIR 


- TYPE 1 DATA TABLE OF THE 
CONVERSION FACTOR FROM POLAR 
TO SIDELINE DIRECTIVITY ANGLE. 


MODULES 

LOAD. 

6ENSUP 


FUNCTIONS 


MODULES CALLED - GENSUP 
PROCEDURES CALLED - XGENSUP 
CALLING PROCEDURES - NONE 
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♦♦♦♦PROCEDURE TCNLJET 


PURPOSE - 


TO COMPUTE JET EXHAUST NOISE USING MODULE Pni ift cno 
STATE^ TABLES?^*^^ PROBLEM WITH INPUT DATA ON ENGINE^” 


AUTHOR - DSW(L03/00/00) 
DSW(L03/00/05) 
MMF(L03/00/09) 

INPUT 

USER PARAMETERS 


IRATIO 


I TYPE 


lUNITS 


PREPRT 


DELTA 

NENG 

SCRXXX 


ENGINE REFERENCE AREA (M**2),(FT**2) 
(RS) (DEFAULT«PI/4. M**2) ^ 

SPECIFIC HEATS OPTION (A) 

8HC0NSTANT - CONSTANT RATIO OF SPECIFIC 
HEATS (DEFAULT) 

8HVARIABLE - VARIABLE RATIO OF SPECIFIC 

TYPE OF INTERPOLATION TO BE USED ON Thf 
engine state tables (I) (0EFA*T.1) 

1 - LINEAR interpolation' 

2 “CUBIC SPLINE INTERPOLATION 
INPUT UNIT OPTION (A) (DEFAULT*2HSI) 

2HSI - SI UNITS ' 

7HENGLISH - ENGLISH UNITS 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

?ilir?FT\ OBSERVER 

(M).(FT) (RS) (DEFAULT* SORT! AE)) 

ANGLE BETWEEN FLIGHT VECTOR AND ENGINE 
INLET AXIS (DEGREES) (RS) (DEFAULT»0 ) 

(oTFA5t{'^!iJ!!j!f ,a, 

CODE FOR NOISE DATA OUTPUT (I) 

(DEFAULT=3) ^ ^ 

0 - NO PRINT BUT GENERATE CNLJETfXXXNNN^ 

1 - OUTPUT PRINT IN OB BUT NO TABLE. ^ 

^ * Buriio TABLE UNLESS FORM 


MODULES 

CNLJET. 

PREJET 

PREJET 

PREJET 


PREJET 


PREJET, 

CNLJET 

PREJET 


CNLJET 

CNLJET 

CNLJET 

CNLJET 

PREJET 

CNLJET 


5-50 


PROCEDURE PROCLIB ( TCNLJET ) 


-3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND DB BUT NO TABLE. 

1 - OUTPUT PRINT IN DB AND GENERATE 

CNLJET(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE CNLJET(XXXNNN). 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND DB AND GENERATE CNLJET(XXXNNN) . 

IPRINT OUTPUT PRINT OPTION FOR CNLJET MODULE 

(I) (DEFAULT=3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

MEMBERS 

FLI (FLIXXX) - MULTI-RECORD MEMBER OF SOURCE 
TIME DATA. 

ENG (PRIM ) - TYPE 1 DATA TABLE OF THE 
PRIMARY NOZZLE FLOW STATE. 

ENG (SEC ) - TYPE 1 DATA TABLE OF THE 

SECONDARY NOZZLE FLOW STATE. 

SFIELD (FREQ ) - ONE RECORD MEMBER OF THE VALUES 
OF FREQUENCY IN HERTZ. 

SFIELD (THETA ) - ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

SFIELD (PHI ) - ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 

JWRCOAN(OM ) - TYPE 1 DATA TABLE OF THE JET 
VARIABLE DENSITY EXPONENT. 

JWRCOAN(PDF ) - TYPE 1 DATA TABLE OF THE POWER 
DEVIATION FACTOR. 

JWRCOAN(Sl ) - TYPE 1 DATA TABLE OF THE PEAK 
STROUHAL NUMBER FOR THE FIRST 
SPECTRUM COMPONENT. 

JWRC0AN(S2 ) - TYPE 1 DATA TABLE OF THE PEAK 
STROUHAL NUMBER FOR THE SECOND 
SPECTRUM COMPONENT. 

JWRCOAN(NSF ) - TYPE 1 DATA TABLE OF THE 

NORMALIZED SPECTRUM FUNCTION. 

JWRCOAN( ALPHA ) - TYPE 1 DATA TABLE OF THE RATIO 
OF THE SECOND COMPONENT SPECTRAL 
PEAK TO THE FIRST COMPONENT 

^PPrTRAI PFAK 

JWRCOAN(CBF ) - TYPE 1 DATA TABLE OF THE 
COANNULAR BENEFIT FACTOR. 


CNLJET 


MODULES 

PREJET 

PREJET 

PREJET 

CNLJET 

CNLJET 

CNLJET 

CNLJET 

CNLJET 

CNLJET 

CNLJET 

CNLJET 

CNLJET 

CNLJET 
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JWRCOAN(DIR ) 
JMRCOAN(MTH ) 
OUTPUT 

USER PARAMETERS 


- type 1 DATA TABLE OF THE 

function. 

- type 1 DATA TABLE OF THE 
FORWARD VELOCITY INDEX. 


CNLJET 

CNLJET 


MODULES 


RS 

CNLERR 


SOURCE TO OBSERVER (M).(FT) 

ERROR PARAMETER (I) 

0 - NO ERRORS ENCOUNTERED. 

MEMBER MANAGER ERROR OCCURRED ON OPEN 
INSUFFICIENT LDS AVAILABLE/ 

MEMBER MANAGER ERROR OCCURRED ON READ. 

fJwUD ^ 

UNABLE TO BUILD TABLE CNLJET(XXXNNN) . 
EXECUTION^ CALCULATED DURING 


1 

2 

3 

4 

5 

6 


CNLJET 

CNLJET 


MEMBERS 

CNLJET(XXXOOl) 

CNLJET(XXXNNN) 


MODULES 


nm TYPE ONE DATA TABLES OF n 
MEAN-SQUARE ACOUSTIC PRESSURE 
FOR NNN SOURCE TIMES. 


CNLJET 


LOCAL 

USER PARAMETERS 


MODULES 


NTIMES 

I 

TIMES 

ATI 

MTA 

MTl 

TTl 

VTl 

RSHTl 

RHOTl 


multi-element parameter CONTAINING THE 
PRIMARY JET AREA FOR EACH TIME rV 

multi-element parameter CONTAINING THE 

AIRCRAFT MACH NUMBER FOR EACH TIME (RS) 
multi-element parameter CONTAINING THE^ 
PRIMARY JET MACH NUMBER FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 

Primary JET total temperatiUe fJr eaw 

link (RS) 

multi-element parameter containing the 

PRIMARY JET VELOCITY FOR EACH T ME (RS) 

multi-element parameter containing THE^ 

specific heats for 

MULTI-ELEMENT PARAMETER CONTAINING THE 
PRIMARY JET DENSITY FOR EACH TIME (RS) 


IF.PREJET 

IF.PARAM 

PREJET, 

PARAM 

PARAM, 

PREJET 

PARAM. 

PREJET 

PREJET 

PARAM, 

PREJET 

PARAM, 

PREJET 

PARAM. 

PREJET 

PARAM. 

PREJET 


5-52 


PROCEDURE PROCLIB ( TCNLJET ) 


OETl MULTI-ELEMENT PARAMETER CONTAINING THE PREJET 

PRIMARY JET EQUIVALENT DIAMETER FOR EACH 
TIME (RS) 

DHTl MULTI-ELEMENT PARAMETER CONTAINING THE PREJET 

PRIMARY JET HYDRAULIC DIAMETER FOR EACH 
TIME (RS) 

CTA MULTI-ELEMENT PARAMETER CONTAINING THE PARAM, 

AMBIENT SPEED OF SOUND FOR EACH TIME PREJET 

(M/S). (FT/S) (RS) 

RHOTA MULTI-ELEMENT PARAMETER CONTAINING THE PARAM. 
AMBIENT DENSITY FOR EACH TIME (KG/M**3). PREJET 
(SLUG/FT**3) (RS) 

AT2 MULTI-ELEMENT PARAMETER CONTAINING THE PARAM. 

SECONDARY JET AREA FOR EACH TIME (RS) PREJET 
MT2 MULTI-ELEMENT PARAMETER CONTAINING THE PREJET 

SECONDARY JET MACH NUMBER FOR EACH TIME 
(RS) 

TT2 MULTI-ELEMENT PARAMETER CONTAINING THE PARAM. 

SECONDARY JET TOTAL TEMPERATURE FOR EACH PREJET 
TIME (RS) 

VT2 MULTI-ELEMENT PARAMETER CONTAINING THE PARAM. 

SECONDARY JET VELOCITY FOR EACH TIME (RS) PREJET 
RH0T2 MULTI-ELEMENT PARAMETER CONTAINING THE PARAM. 

SECONDARY JET DENSITY FOR EACH TIME (RS) PREJET 
RSHT2 MULTI-ELEMENT PARAMETER CONTAINING THE PARAM. 

SECONDARY JET RATIO OF SPECIFIC HEATS PREJET 

FOR EACH TIME (RS) 

DET2 MULTI-ELEMENT PARAMETER CONTAINING THE PREJET 

SECONDARY JET EQUIVALENT DIAMETER FOR 

EACH TIME (RS) 

0HT2 MULTI-ELEMENT PARAMETER CONTAINING THE PARAM. 

SECONDARY JET HYDRAULIC DIAMETER FOR PREJET 

EACH TIME (RS) 

A1 VALUE OF PRIMARY JET AREA FOR TIME I (RS) PARAM. 

CNLJET 

T1 VALUE OF PRIMARY JET TOTAL TEMPERATURE PARAM. 

FOR TIME I (RS) CNLJET 

VI VALUE OF PRIMARY JET VELOCITY FOR TIME I PARAM. 

(RS) CNLJET 

RHOl VALUE OF PRIMARY JET DENSITY FOR TIME I PARAM. 

(RS) CNLJET 

GAMMAl VALUE OF PRIMARY JET RATIO OF SPECIFIC PARAM. 

HEATS FOR TIME I (RS) CNLJET 

A2 VALUE OF SECONDARY JET AREA FOR TIME I PARAM. 

(RS) CNLJET 

DH2 VALUE OF SECONDARY JET HYDRAULIC DIAMETER PARAM. 

FOR TIME I (RS) CNLJET 

T2 VALUE OF SECONDARY JET TOTAL TEMPERATURE PARAM. 

FOR TIME I (RS) CNLJET 
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n VALUE OF SECONDARY JET VELOCITY FOR PARAM, 

TIME I (RS) CNLJET 

RH02 VALUE OF SECONDARY JET DENSITY FOR TIME I PARAM, 

(RS) CNLJET 

6AMMA2 VALUE OF SECONDARY JET RATIO OF SPECIFIC PARAM, 

HEATS FOR TIME I (RS) CNLJET 

CA VALUE OF AMBIENT SPEED OF SOUND FOR PARAM, 

TIME I (M/S), (FT/S) (RS) CNLJET 

RHOA VALUE OF AMBIENT DENSITY FOR TIME I PARAM, 

(KG/M**3),(SLU6/FT**3) (RS) CNLJET 

MA VALUE OF AIRCRAFT MACH NUMBER FOR TIME I PARAM, 

(RS) CNLJET 

SCKNNN INDEX FOR SOURCE MEMBER NAME » I (I) PARAM, 

CNLJET 

STIME VALUE OF SOURCE TIME FOR TIME I (RS) PARAM, 

CNLJET 

MEMBERS - NONE 
FUNCTIONS 

1. LOAD JWRCOAN AND SFIELD DATA UNITS IF NOT ASSIGNED. 

2. EXECUTE PREJET MODULE TO GET JET NOISE PARAMETERS. 

3. INITIALIZE SOURCE TIME LOOP. 

4. EXECUTE CNLJET MODULE FOR EACH SOURCE TIME ON FLI(FLIXXX) 
UNIT MEMBER. 

MODULES CALLED - PREJET CNLJET 
PROCEDURES CALLED - XPREJET XCNLJET 
CALLING PROCEDURES - NONE 
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DETl 

OHTl 

CTA 

RHOTA 

AT2 

MT2 

TT2 

VT2 

RH0T2 

RSHT2 

OET2 

DHT2 

A1 

T1 

VI 

RHOl 

GAMMAl 

A2 

0H2 

T2 


PRIfSARV^^rf’^JnmSJf’Kr'^ CONTAINING THE 
TIME (Rsf ^ equivalent DIAMETER FOR EACH 

CONTAINING THE 
fiMMRsf ^ M'^ORAULIC diameter FOR EACH 

multi-element parameter containing THF 
multi-element parameter containing THE 

multi-element parameter containing the 

*^ET MACH NUMBER FOR EACH TIME 

MULTI-ELEMENT PARAMETER CONTAINING THE 
T?«"(Js) «HPeKe F§R E«H 

parameter containing THE 

SECONDARY JET VELOCITY FOR EACH TIME 
MULTI-ELEMENT PARAMETER CONTAiJiISg THE ’ 
SECONDARY JET DENSITY FOR EACH TIME IRS^ 

multi-element PARAMETER CONTAVNliGTHf^ 

UCT RATIO OF SPECIFIC HEATS 

for each time (RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
EaS*^TIME ^JJj^^UIVALENT DIAMETER FOR 

?H!:P“^^^MENT PARAMETER CONTAINING THE 

Ia“ ??« dia^^ter for 

VALUE OF PRIMARY JET AREA FOR TIME I (RS) 

foretime ^(RS)^ ^^mperature 

(RS)^ primary jet VELOCITY FOR TIME I 
(Rsf primary jet DENSITY FOR TIME I 

1!?aSI uet ratio of specific 

HEATS FOR TIME I (RS) 

value of SECONDARY JET AREA FOR TIME I 

foretime f (RS)^*^^ hydraulic DIAMETER 

FOr'^TIME f 


PREJET 


PREJET 


PAR AM. 
PREJET 

PARAM, 

PREJET 

PARAM, 

PREJET 

PREJET 


PARAM, 

PREJET 

PARAM, 

PREJET 

PARAM, 

PREJET 

PARAM. 

PREJET 

PREJET 


PARAM. 

PREJET 

PARAM, 

CNLJET 

PARAM, 

CNLJET 

PARAM. 

CNLJET 

PARAM. 

CNLJET 

PARAM, 

CNLJET 

PARAM, 

CNLJET 

PARAM, 

CNLJET 

PARAM, 

CNLJET 
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titifir 


PROCEDURE TFNKAFM 

PURPOSE - TO COMPUTE AIRFRAME NOISE USING MODULE FNKAFM FOR A 
TIME DEPENDENT PROBLEM. 

AUTHOR - DSW(L03/00/00) 

DSW L03/00/05) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS 


MODULES 


AF 

AH 

AV 

AW 

BF 

BH 

BV 

BW 

DMG 

DNG 

LM6 

LNG 

RS 

NWMG 

NWNG 

NMG 

NNG 

NS 

PREPRT 


FLAP AREA (M**2) .(FT**2) (RS) 

(DEFAULT-IO. M**2) 

HORIZONTAL TAIL AREA (M**2) ,(FT**2) (RS) 
(DEFAULT=20. M**2) ^ v ; 

VERTICAL TAIL AREA (M**2) ,(FT**2) (RS) 
(DEFAULT=20. M**2) ' ^ 

WING AREA (M**2),(FT**2) (RS) 
(DEFAULT=100. M**2) 

FLAP SPAN (M),(FT) (RS) (DEFAULT=5. M) 
HORIZONTAL TAIL SPAN (M),(FT) (RS) 
(DEFAULT»10. M) ' / v / \ / 

VERTICAL TAIL SPAN (M),(FT) (RS) 
(OEFAULT^IO. M) 

WING SPAN (M).(FT) (RS) (DEFAULT=20. M) 
TIRE DIAMETER OF MAIN LANDING GEAR (M). 
(FT) (RS) (DEFAULT=1. M) 

TIRE DIAMETER OF NOSE LANDING GEAR (M). 
(FT) (RS) (DEFAULT=1. M) 

MAIN LANDING GEAR STRUT LENGTH (M).(FT) 
(RS) (DEFAULT=3. M) v / 

NOSE LANDING GEAR STRUT LENGTH (M),(FT) 
(RS) (DEFAULT»3. M) 

DISTANCE FROM SOURCE TO OBSERVER (M).(FT) 
(RS) (OEFAULT=BW) ' ' 

NUMBER OF WHEELS PER MAIN LANDING GEAR 
(I) (DEFAULT»4) 

NUMBER OF WHEELS PER NOSE LANDING GEAR 
(I) (0EFAULT=2) 

NUMBER OF MAIN LANDING GEAR (I) 
(DEFAULT=2) 

NUMBER OF NOSE LANDING GEAR (I) 
(DEFAULT*!) 

NUMBER OF SLOTS FOR TRAILING EDGE FLAPS 
(I) (DEFAULT* 3) 

OUTPUT PRINT CODE FOR PREAFM MODULE (I) 
(DEFAULT*3) ' 

0 - NO PRINT 

1 - INPUT PRINT ONLY 


FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

FNKAFM 

PREAFM 
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2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

I OUT OUTPUT CODE FOR TABLE AND PRINTED OUTPUT FNKAFM 
(I) (DEFAULT=3) 

0 - NO PRINT BUT GENERATE FNKAFM(XXXNNN) . 

-1 - OUTPUT PRINT IN DB BUT NO TABLE. 

-2 - OUTPUT PRINT IN DIMENSIONLESS FORM 
BUT NO TABLE. 

-3 - OUTPUT PRINT IN DIMENSIONLESS FORM 
AND DB BUT NO TABLE. 

1 - OUTPUT PRINT IN DB AND GENERATE 

FNKAFM(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE FNKAFM(XXXNNN). 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND DB AND GENERATE FNKAFM(XXXNNN) . 

I PR I NT OUTPUT PRINT CODE FOR FNKAFM MODULE (I) FNKAFM 
(0EFAULT=3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

SCRXXX THREE LETTER ID USED TO FORM MEMBER NAMES PREAFM, 
FLI(FLIXXX) AND FNKAFM(XXXNNN) (A) FNKAFM 

(DEFAULT»3HXXX) 

DYNCLN DESCRIPTION OF AIRCRAFT (L) FNKAFM 

(DEFAULT*. FALSE.) 

.TRUE. - AERODYNAMICALLY CLEAN AIRCRAFT 
.FALSE. - NON-AERODYNAMICALLY CLEAN 
AIRCRAFT 

OELTAW TYPE OF WING PLANFORM (L) FNKAFM 

(DEFAULT*. FALSE.) 

.TRUE. - DELTA-W INGEO AIRCRAFT 
.FALSE. - RECTANGULAR-WINGED AIRCRAFT 
lUNITS UNIT OPTION CODE (A) (OEFAULT*2HSI) FNKAFM. 

2HSI - SI UNITS PREAFM 

7HENGLISH - ENGLISH UNITS 


(THE NEXT SEVEN PARAMETERS HAVE THE FOLLOWING VALUES) 
( .TRUE. - INCLUDE IN TOTAL PREDICTION ) 
( .FALSE. - DO NOT INCLUDE ) 


TEWN 

TRAILING EDGE WING NOISE (L) 
( DEFAULT*. TRUE. > 

FNKAFM 

TEHTN 

TRAILING EDGE HORIZONTAL TAIL NOISE (L) 
(DEFAULT*. TRUE.) 

FNKAFM 

TEVTN 

TRAILING EDGE VERTICAL TAIL NOISL (L) 
(DEFAULT*. TRUE.) 

FNKAFM 

TEFN 

TRAILING EDGE FLAP NOISE (L) 
(DEFAULT*. FALSE.) 

FNKAFM 
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LESN LEADING EDGE SLAT NOISE (L) 

(DEFAULT*. FALSE.) 

MLGN MAIN LANDING GEAR NOISE (L) 

(DEFAULT*. TRUE.) 

NLGN NOSE LANDING GEAR NOISE (L) 

(DEFAULT*. TRUE.) 

MEMBERS 

FLI (FLIXXX) - MULTI-RECORD MEMBER OF SOURCE 
TIME DATA. 

SF I ELD (FREQ ) - ONE RECORD MEMBER OF THE VALUES 
OF FREQUENCY IN HERTZ. 

SFIELD(THETA) - ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

SFIELD(PHI ) - ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN OEGRETiS. 

OUTPUT 

USER PARAMETERS 

RS DISTANCE FROM SOURCE TO OBSERVER (M).(FT) 
(RS) 


MEMBERS 

FNKAFM(XXXOOl) - NNN TYPE ONE DATA TABLES OF THE 
... MEAN-SQUARE ACOUSTIC PRESSURE 

FNKAFM(XXXNNN) FOR NNN SOURCE TIMES 

LOCAL 

USER PARAMETERS 

NTIMES NUMBER OF SOURCE TIME VALUES (I) 

I LOOP INDEX (I) 

TIMES MULTI-ELEMENT PARAMETER CONTAINING THE 

SOURCE TIMES (RS) 

LANOTG MULTI-ELEMENT PARAMETER CONTAINING THE 
LANDING GEAR POSITION FOR EACH TIME (A) 
MTA MULTI-ELEMENT PARAMETER CONTAINING THE 

AIRCRAFT MACH NUMBER FOR EACH TIME (RS) 
OELTATF MULTI-ELEMENT PARAMETER CONTAINING THE 
FLAP SETTING ANGLE FOR EACH TIME (RS) 

CTA MULTI-ELEMENT PARAMETER CONTAINING THE 

AMBIENT SPEED OF SOUND FOR EACH TIME 
(M/S).(FT/S) (RS) 

RHOTA MULTI-ELEMENT PARAMETER CONTAINING THE 
AMBIENT DENSITY FOR EACH TIME (K6/M**3), 
(SLUG/FT**3) (RS) 


FNKAFM 

FNKAFM 

FNKAFM 


MODULES 

PREAFM 

FNKAFM 

FNKAFM 


FNKAFM 


MODULES 

FNKAFM 


MODULES 

FNKAFM 


MODULES 

IF. PREAFM 
IF.PARAM 
PARAM, 
PREAFM 
PARAM. 
PREAFM 
PARAM. 
PREAFM 
PARAM. 
PREAFM 
PARAM. 
PREAFM 

PARAM. 

PREAFM 


PROCEDURE PROCUB ( TFNKAFM ) 


MUTA 


LANDG 


MULTI-ELEMENT PARAMETER CONTAINING THE 
DYNAMIC VISCOSITY FOR EACH TIME 
(KG/(M S)),(SLUG/(FT S)) (RS) 

LANDING GEAR POSITION FOR TIME I (A) 


MA AIRCRAFT MACH NUMBER FOR TIME I (RS) 


DELTAF FLAP SETTING ANGLE FOR TIME I (RS) 


STIME SOURCE TIME FOR TIME I (RS) 


CA *"OR TIME I (M/S), 

RHOA AMBIENT DENSITY FOR TIME I (KG/M**3). 

(SLUG/FT**3) (RS) ' 

MUA DYNAMIC VISCOSITY AT TIME I (KG/(M S)). 

(SLUG/(FT S)) (RS) ^ 

SCRNNN INDEX FOR SOURCE MEMBER NAME » I (I) 


PARAM, 

PREAFM 

PARAM, 

FNKAFM 

PARAM, 

FNKAFM 

PARAM, 

FNKAFM 

PARAM, 

FNKAFM 

PARAM, 

FNKAFM 

PARAM, 

FNKAFM 

PARAM. 

FNKAFM 

PARAM. 

FNKAFM 


MEMBERS - NONE 
FUNCTIONS 

1. LOAD SFIELD DATA UNIT IF NOT ASSIGNED. 

2. EXECUTE PREAFM MODULE TO GET AIRFRAME NOISE PARAMETERS. 

3. INITIALIZE SOURCE TIME LOOP. 

4. EXECUTE FNKAFM MODULE FOR EACH SOURCE TIME ON FLIfFLIXXX) 

UNIT MEMBER. rLurLXAAX; 

MODULES CALLED - PREAFM FNKAFM 
PROCEDURES CALLED - XPREAFM XFNKAFM 
CALLING PROCEDURES - NONE 
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♦♦♦♦PROCEDURE TGECOR 

PURPOSE - TO COMPUTE THE COMBUSTION NOISE USING MODULE GECOR 
FOR A TIME DEPENDENT PROBLEM WITH INPUT DATA ON 
ENGINE STATE TABLES. 

AUTHOR - DSW(L03/00/00) 

DSW(L03/00/05) 

MMF(L03/00/09) 


INPUT 

USER PARAMETERS MODULES 

AE ENGINE REFERENCE AREA (M**2) ,(FT^^2) GECOR 

(RS) (0EFAULT=0.7854 M^^2) 

A COMBUSTOR ENTRANCE AREA, RE AE (RS) GECOR 

(DEFAULT* 1.) 

PREPRT OUTPUT PRINT OPTION FOR PRECOR MODULE PRECOR 
(I) (DEFAULT-3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

lUNITS INPUT UNIT OPTION (A) (DEFAULT-2HSI) PRECOR, 

2HSI - SI UNITS GECOR 

7HENGLISH - ENGLISH UNITS 


ITYPE TYPE OF INTERPOLATION TO BE USED ON THE PRECOR 
ENGINE STATE TABLES (I) (DEFAULT-1) 

1 - LINEAR INTERPOLATION 

2 - CUBIC SPLINE INTERPOLATION 

RS DISTANCE FROM SOURCE TO OBSERVER (M),(FT) GECOR 


(RS) (DEFAULT-SQRT(AE)) 

NENG NUMBER OF ENGINES (I) (OEFAULT-1) GECOR 

SCRXXX THREE LETTER ID USED TO FORM MEMBER NAME GECOR, 
FLI(FLIXXX) AND GECOR(XXXNNN) (A) PRECOR 

(DEFAULT-3HXXX) 

I OUT CODE FOR NOISE DATA OUTPUT (I) GECOR 


(DEFAULT-3) 

0 - NO PRINT BUT GENERATE GECOR(XXXNNN) . 
-1 - OUTPUT PRINT IN DB BUT NO TABLE. 

-2 - OUTPUT PRINT IN DIMENSIONLESS FORM 
BUT NO TABLE. 

-3 - OUTPUT PRINT IN DIMENSIONLESS FORM 
AND OB BUT NO TABLE. 

1 - OUTPUT PRINT IN DB AND GENERATE 

GECOR(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE GECOR(XXXNNN) . 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND OB AND GENERATE GECOR(XXXNNN) . 
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IPRINT OUTPUT PRINT OPTION FOR 6EC0R MODULE 6EC0R 

(I) (DEFAULT«3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

TDDELT DESIGN TURBINE TEMPERATURE RISE, 6EC0R 

RE AMBIENT TEMPERATURE (RS) 

(DEFAULTED. 5 ) 


MEMBERS 
FLI (FLIXXX) 
ENG (COREl ) 

ENG (C0RE2 ) 

SFIELD(FREQ ) 
SFIELD(THETA ) 


MULTI-RECORD MEMBER OF SOURCE 
TIME DATA. 

TYPE 1 DATA TABLE OF THE CORE 
ENTRANCE FLOW STATE DATA. 

TYPE 1 DATA TABLE OF THE CORE 
EXIT FLOW STATE DATA. 

ONE RECORD MEMBER OF THE VALUES 
OF FREQUENCY IN HERTZ. 

ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

SFIELD(PHI ) - ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 


MODULES 

PRECOR 

PRECOR 

PRECOR 

PRECOR 

PRECOR 

PRECOR 


OUTPUT 

USER PARAMETERS 


MODULES 


RS 

GECERR 


RADIAL^DISTANCE FROM SOURCE TO OBSERVER 

ERROR PARAMETER (I) 

0 - NO ERRORS ENCOUNTERED. 

MEMBER MANAGER ERROR OCCURRED ON OPEN 
INSUFFICIENT LDS AVAILABLE. 

MEMBER MANAGER ERROR OCCURRED ON READ 
AT LEAST ONE USER PARAMETER HAS AN 
INVALID VALUE. 

GECOR(XXXNNN). 

AN INVALID VALUE WAS CALCULATED DURIN 
EXECUTION. 


GECOR 


MEMBERS 


MODULES 


GECOR (XXXOOl) 
GECOR ‘(XXXNNN) 


NNN TYPE 1 DATA TABLES OF THE 
MEAN-SQUARE ACOUSTIC PRESSURE 
FOR NNN SOURCE TIMES. 


GECOR 
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LOCAL 

USER PARAMETERS MODULES 

NTIMES NUMBER OF SOURCE TIME VALUES (I) IF.PRECOR 

I LOOP INDEX (I) IF.PARAM 

TIMES MULTI-ELEMENT PARAMETER CONTAINING THE PARAM. 

SOURCE TIMES (RS) PRECOR 

MTl MULTI-ELEMENT PARAMETER CONTAINING THE PARAM, 

ENTRANCE MASS FLOW RATE FOR EACH TIME (RS) PRECOR 
MTA MULTI-ELEMENT PARAMETER CONTAINING THE PARAM, 

AIRCRAFT MACH NUMBER FOR EACH TIME (RS) PRECOR 

PTl MULTI-ELEMENT PARAMETER CONTAINING THE PARAM, 

COMBUSTOR ENTRANCE TOTAL PRESSURE FOR PRECOR 

LACH TIME (RS) 

TTl MULTI-ELEMENT PARAMETER CONTAINING THE PARAM, 

COMBUSTOR ENTRANCE TOTAL TEMPERATURE FOR PRECOR 

EACH TIME (RS) 

TT2 MULTI-ELEMENT PARAMETER CONTAINING THE PARAM, 

COMBUSTOR EXIT TOTAL TEMPERATURE FOR EACH PRECOR 

TIME (RS) 

CTA MULTI-ELEMENT PARAMETER CONTAINING THE PARAM, 

AMBIENT SPEED OF SOUND FOR EACH TIME (RS) PRECOR 

RHOTA MULTI-ELEKENT PARAMETER CONTAINING THE PARAM, 

AMBIENT DENSITY FOR EACH TIME (RS) PRECOR 

STIME SOURCE TIME VALUE FOR TIME I (RS) PARAM, 

GECOR 

MOOT COMBUSTOR ENTRANCE MASS FLOW RATE FOR PARAM, 

time I (RS) GECOR 

MA AIRCRAFT MACH NUMBER FOR TIME I (RS) PARAM, 

GECOR 

PI COMBUSTOR ENTRANCE TOTAL PRESSURE FOR PARAM, 

TIME I (RS) GECOR 

TI COMBUSTOR ENTRANCE TOTAL TEMPERATURE PARAM, 

FOR TIME I (RS) GECOR 

TJ COMBUSTOR EXIT TOTAL TEMPERATURE FOR PARAM, 

time I (RS) GECOR 

CA AMBIENT SPEED OF SOUND FOR TIME I (M/S), PARAM, 

(FT/S) (RS) GECOR 

RHOA AMBIENT DENSITY FOR TIME I (K6/M**3), PARAM, 

(SLU6/FT**3) (RS) GECOR 

SCRNNN INDEX FOR SOURCE MEMBER NAME « I (I) PARAM, 

GECOR 


MEMBERS - NONE 
FUNCTIONS 

1. LOAD SFIELD DATA UNIT IF NOT ASSIGNED. 

2. EXECUTE PRECOR MODULE TO GET CORE NOISE PARAMETERS. 
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3. INITIALIZE SOURCE TIME LOOP. 

4. EXECUTE GECOR MODULE FOR EACH SOURCE TIME ON FLI(FLIXXX) 
UNIT MEMBER. 

MODULES CALLED > PRECOR GECOR 
PROCEDURES CALLED - XPRECOR XGECOR 
CALLING PROCEDURES - NONE 
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♦♦♦♦procedure TGETUR 

PURPOSE - TO COMPUTE THE TURBINE NOISE USING MODULE GETUR 
FOR A TIME DEPENDENT PROBLEM WITH INPUT DATA ON 
ENGINE STATE TABLES. 

AUTHOR - DSW(L03/00/00) 

WKB(L03/00/01) 

DSW(L03/00/05 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS MODULES 

AE ENGINE REFERENCE AREA (M**2) ,{FT**2) (RS) GETUR 

(DEFAULT=PI/4. M**2) 

NENG NUMBER OF ENGINES (I) (DEFAULT=1) GETUR 

RS DISTANCE FROM SOURCE TO OBSERVER (M).(FT) GETUR 

(RS) (OEFAULT=SQRT(AE)) 

AREA TURBINE INLET CROSS-SECTIONAL AREA, RE AE GETUR 

(RS) (DEFAULT=1.) 

NBLADE NUMBER OF ROTOR BLADES (I) (DEFAULT=20) GETUR 

D TURBINE ROTOR DIAMETER, RE SQRT(AE) (RS) GETUR 

(DEFAULT=1.) 

SCRXXX THREE LETTER ID USED TO FORM MEMBER NAME GETUR, 

FLI(FLIXXX) AND GETUR(XXXNNN) (A) PRETUR 

(DEFAULT*3HXXX) 

BROAD BROADBAND NOISE OPTION (L) GETUR 

.TRUE. COMPUTE BROADBAND NOISE (DEFAULT) 

.FALSE. DO NOT COMPUTE 

PURE PURE TONE OPTION (L) GETUR 

.TRUE. COMPUTE PURE TONES (DEFAULT) 

.FALSE. DO NOT COMPUTE 

I OUT OUTPUT CODE FOR TABLE AND PRINTED OUTPUT GETUR 

(I) (DEFAULT«3) 

0 - NO PRINT BUT GENERATE GETUR(XXXNNN). 

-1 - OUTPUT PRINT IN OB BUT NO TABLE. 

-2 - OUTPUT PRINT IN DIMENSIONLESS FORM 
BUT NO TABLE. 

-3 - OUTPUT PRINT IN DIMENSIONLESS FORM 
AND UB BUT NO TABLE. 

1 - OUTPUT PRINT IN DB AND GENERATE 

GETUR(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE GETUR(XXXNNN) . 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND DB AND GENERATE GETUR(XXXNNN). 
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IPRINT 

lUNITS 

ITYPE 

IRATIO 

PREPRT 


OUTPUT PRINT CODE FOR GETUR MODULE 
(I) (DEFAULT«3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 
INPUT UNIT OPTION (A) (DEFAULTa2HSI) 
2HSI - SI UNITS 

7HENGLISH - ENGLISH UNITS 

TYPE OF INTERPOLATION TO BE USED ON THE 

ENGINE STATE TABLES (I) (DEFAULT=1) 

1 - LINEAR INTERPOLATION 

2 - CUBIC SPLINE INTERPOLATION 
SPECIFIC HEATS OPTION (A) 

8HC0NSTANT - CONSTANT RATIO OF SPECIFIC 

HEATS (DEFAULT) 

8HVARIABLE - VARIABLE RATIO OF SPECIFIC 


HEATS 

OUTPUT PRINT CODE FOR PRETUR MODULE 
(I) (DEFAULT=3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 


GETUR 


GETUR, 

PRETUR 

PRETUR 

PRETUR 


PRETUR 


MEMBERS 


MODULES 


FLI (FLIXXX ) 
ENG (TURBINEl) 
ENG (TURBINE2) 
SFIELD(FREQ ) 
SFIELD(THETA ) 

SFIELD(PHI ) 


MULTI-RECORD MEMBER OF SOURCE 
TIME DATA. 

TYPE 1 DATA TABLE OF THE 
TURBINE ENTRANCE FLOW STATE. 
TYPE 1 DATA TABLE OF THE 
turbine exit FLOW STATE. 

ONE RECORD MEMBER OF THE VALUES 
OF FREQUENCY IN HERTZ. 

ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 


PRETUR 

PRETUR 

PRETUR 

GETUR 

GETUR 

GETUR 


OUTPUT 

USER PARAMETERS 


MODULES 


RS 


DISTANCE 

(RS) 


FROM SOURCE TO OBSERVER (M),(FT) 


GETUR 


PROCEDURE PROCLIB ( T6ETUR ) 


6ETERR 


ERROR PARAMETER (1) 

0 - NO ERRORS ENCOUNTERED. 


1 - MEMBER MANAGER ERROR OCCURRED ON OPEN. 

2 - INSUFFICIENT LDS AVAILABLE. 

3 - MEMBER MANAGER ERROR OCCURRED ON READ. 

4 - AT LEAST ONE USER PARAMETER HAS AN 

INVALID VALUE. 


5 - UNABLE TO BUILD TABLE GETUR(XXXNNN) 

6 - AN INVALID VALUE WAS CALCULATED DURING 

EXECUTION. 


GETUR 


MEMBERS 


MODULES 


GETUR (XXXOOl) 
GETUR (XXXNNN) 


NNN TYPE 1 DATA TABLES OF THE 
MEAN-SQUARE ACOUSTIC PRESSURE 
FOR NNN SOURCE TIMES. 


LOCAL 

USER PARAMETERS 


GETUR 


MODULES 


NTIMES 

I 

TIMES 

MTA 

MTl 

NTl 

TTl 

TT2 

CTA 

RHOTA 

FTA 

HTA 

MA 

ROTSPD 


NUMBER OF SOURCE TIME VALUES (I) 

LOOP INDEX (I) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
SOURCE TIMES (RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
AIRCRAFT MACH NUMBER FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
CORE MASS FLOW RATE FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
ROTATIONAL SPEED FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
ENTRANCE TOTAL TEMPERATURE FOR EACH TIME 
(RS) 


IF.PRETUR 
IF.PARAM 
PRETUR 
PARAM 
PAR AM. 
PRETUR 
PRETUR 

PARAM. 

PRETUR 

PARAM. 

PRETUR 


MULTI-ELEMENT PARAMETER CONTAINING THE 
EXIT STATIC TEMPERATURE FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
AMBIENT SPEED OF SOUND FOR EACH TIME 
(M/S). (FT/S) (RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
AMBIENT DENSITY FOR EACH TIME (K6/M**3). 
(SLU6/FT**3) (RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
FUEL-TO-AIR RATIO FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
ABSOLUTE HUMIDITY FOR EACH TIME (RS) 
AIRCRAFT MACH NUMBER AT TIME I (RS) 

ROTATIONAL SPEED AT TIME I (RS) 


PARAM. 

PRETUR 

PARAM. 

PRETUR 

PARAM. 

PRETUR 

PARAM. 

PRETUR 

PARAM. 

PRETUR 

PARAM. 

GETUR 

PARAM. 

GETUR 
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TTI 

ENTRANCE TOTAL TEMPERATURE AT TIME I (RS) 

PARAM, 

GETUR 

TSJ 

EXIT STATIC TEMPERATURE AT TIME I (RS) 

PARAM, 

GETUR 

CA 

AMBIENT SPEED OF SOUND AT TIME I (M/S), 

PARAM, 


(FT/S) (RS) 

GETUR 

RHOA 

AMBIENT DENSITY AT TIME I (KG/M**3), 

PARAM, 


(SLUG/FT**3) (RS) 

GETUR 

SCRNNN 

INDEX FOR SOURCE MEMBER NAME » I (I) 

PARAM, 

GETUR 

ST I ME 

SOURCE TIME VALUE AT TIME I (RS) 

PARAM, 

GETUR 

F 

FUEL-TO-AIR RATIO AT TIME I (RS) 

PARAM, 

GETUR 

HA 

ABSOLUTE HUMIDITY AT TIME I (RS) 

PARAM, 

GETUR 


MEMBERS - NONE 
FUNCTIONS 

1. LOAD SFIELO DATA UNIT IF NOT ASSIGNED. 

2. EXECUTE PRETUR MODULE TO GET TURBINE NOISE PARAMETERS. 

3. INITIALIZE SOURCE TIME LOOP. 

4. EXECUTE 6ETUR MODULE FOR EACH SOURCE TIME ON FLI(FLIXXX) 
UNIT MEMBER. 

MODULES CALLED - PRETUR GETUR 
PROCEDURES CALLED - XPRETUR X6ETUR 
CALLING PROCEDURES - NONE 
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****PROCEDURE THDNFAN 

PURPOSE - TO COMPUTE FAN NOISE USING M<3DU|.F. HDNFAN FOR A TIME 
DEPENDENT PROBLEM WITH INPUT DATA ON ENGINE STATE 
TABLES. 

AUTHOR - DSW(L03/00/00) 

WKB(L03/00/01 

0SW(L03/00/05 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS MODULES 

PREPRT OUTPUT PRINT OPTION FOR PREFAN MODULE PREFAN 

(1) (OEFAULT=3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

lUNITS INPUT UNIT OPTION (A) (DEFAULT=2HSI) PREFAN. 

2HSI - SI UNITS HONFAN 

7HEN6LISH - ENGLISH UNITS 

ITYPE TYPE OF INTERPOLATION TO BE USED ON THE PREFAN 
ENGINE STATE TABLES (I) (OEFAULT=l) 

1 - LINEAR INTERPOLATION 

2 - CUBIC SPLINE INTERPOLATION 

AE ENGINE REFERENCE AREA (M**2) .(FT**2) (RS) HONFAN 
(DEFAULT=PI/4. M**2) 

RS DISTANCE FROM SOURCE TO OBSERVER (M).(FT) HONFAN 

(RS) (DEFAULT* SQRT(AE)) 

AFAN FAN INLET CROSS-SECTIONAL AREA, RE AE HDNFAN 

(RS) (DEFAULT* 1.) 

DIAM FAN ROTOR DIAMETER, RE SQRT(AE) (RS) HDNFAN 

(DEFAULT*!. 128) 

MD FAN ROTOR RELATIVE TIP MACH NUMBER AT HDNFAN 

DESIGN POINT (RS) (DEFAULT*!.) 

RSS ROTOR-STATOR SPACING, RE MEAN ROTOR BLADE HDNFAN 

CHORD (RS) (DEFAULT*!.) 

NBANDS NUMBER OF !/3 OCTAVE BANDS FOR TONE HDNFAN 

FREQUENCY SHIFT (I) (0EFAULT*0) 

NENG NUMBER OF ENGINES (I) (DEFAULT*!) HDNFAN 

NB NUMBER OF ROTOR BLADES (I) (DEFAULT«20) HDNFAN 

NV NUMBER OF STATOR VANES (I) (0EFAULT*50 HDNFAN 

IGV INLET GUIDE VANE INDEX (I) (DEFAULT*!) HDNFAN 

! - FOR A FAN WITHOUT IGV'S 
2 - FOR A FAN WITH IGV'S 

DIS INLET FLOW DISTORTION INDEX (I) HDNFAN 

! - NO INLET FLOW DISTORTION (DEFAULT) 

2 - INLET FLOW DISTORTED 
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-1 - 
-2 - 

• 3 •• 


2 - 


HDNFAN 


I OUT OUTPUT CODE FOR TABLE AND PRINTED OUTPUT HDNFAN 

0^- no^prInt but generate HDNFAN(XXXNNN). 

OUTPUT PRINT IN OB BUT NO TABLE. 

OUTPUT PRINT IN DIMENSIONLESS FORM 

OUTPUT PRINT IN DIMENSIONLESS FORM 
AND OB BUT NO TABLE. 

OUTPUT PRINT IN DB AND GENERATE 
HONFAN(XXXNNN). 

OUTPUT PRINT IN DIMENSIONLESS FORM 
AND GENERATE HDNFAN(XXXNNN) . 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 
AND DB AND GENERATE HDNFAN(XXXNNN) . 

IPRINT OUTPUT PRINT OPTION FOR HDNFAN MODULE 
(I) (0EFAULT»3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

THREE LETTER ID USED TO FORM MEMBER NAME 
SCRXXX JHREE^LETItK^IU 

(DEFAULT»3HXXX) 

/TMF NFXT SIX PARAMETERS HAVE THE FOLLOWING VALUES (!•) | 

THE NEXT SlX^PAR^TtKJ^^ PREDICTION (DEFAULT) 

( .FALSE. - DO NOT INCLUDE ) 

INRS INLET ROTOR-STATOR INTERACTION TONES 

INCT COMBINATION TONE NOISE 

INDIS INLFT FLOW DISTORTION TONES 

INBB INLET BROADBAND NOISE 

IDRS DISCHARGE ROTOR-STATOR INTERACTION TONES 

lOBB DISCHARGE BROADBAND NOISE 


HDNFAN. 

PREFAN 


MEMBERS 

FLI (FLIXXX) 
ENG (FANl ) 
ENG (FAN2 ) 
SFIELO(FREQ ) 
SFIELD(THETA ) 



MODULES 

- multi-record member of SOURCE 

PREFAN 

TIME DATA. 

- TYPE 1 DATA TABLE OF THE FAN 

PREFAN 

ENTRANCE FLOW STATE. 

- TYPE 1 DATA TABLE OF THE FAN 

PREFAN 

EXIT FLOW STATE. 

- ONE RECORD MEMBER OF THE VALUES 

HDNFAN 

OF FREQUENCY IN HERTZ. 

- ONE RECORD MEMBER OF THE VALUES 

HDNFAN 

OF POLAR DIRECTIVITY ANGLE IN 



DEGREES. 
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SFIELD(PHI ) - ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 

OUTPUT 

USER PARAMETERS 

RS DISTANCE FROM SOURCE TO OBSERVER (M),(FT) 
(RS) 

MEMBERS 

HDNI AN(XXXOOl) - NNN TYPE ONE DATA TABLES OF THE 
... MEAN-SQUARE ACOUSTIC PRESSURE 

HDNFAN(XXXNNN) FOR NNN SOURCE TIMES. 

LOCAL 

USER PARAMETERS 

NTIMES NUMBER OF SOURCE TIME VALUES (I) 

I LOOP INDEX (I) 

TIMES MULTI-ELEMENT PARAMETER CONTAINING THE 

SOURCE TIMES (RS) 

MTl MULTI-ELEMENT PARAMETER CONTAINING THE 
FAN MASS FLOW RATE FOR EACH TIME (RS) 

MTA MULTI-ELEMENT PARAMETER CONTAINING THE 

AIRCRAFT MACH NUMBER FOR EACH TIME (RS) 

NTl MULTI-ELEMENT PARAMETER CONTAINING THE 

ROTATIONAL SPEED FOR EACH TIME (RS) 

OTl MULTI-ELEMENT PARAMETER CONTAINING THE 

FAN TOTAL TEMPERATURE RISE FOR EACH 
TIME (RS) 

MT2 MULTI-ELEMENT PARAMETER CONTAINING THE 

EXIT MASS FLOW RATE FOR EACH TIME (RS) 

CTA MULTI-ELEMENT PARAMETER CONTAINING THE 

AMBIENT SPEED OF SOUND FOR EACH TIME 

(M/S),(FT/S) (RS) 

RHOTA MULTI-ELEMENT PARAMETER CONTAINING THE 
AMBIENT DENSITY FOR EACH TIME (KG/M**3), 
(SLUG/FT**3) (RS) 

MOOT VALUE OF MASS FLOW RATE FOR TIME I (RS) 

MA VALUE OF AIRCRAFT MACH NUMBER FOR TIME I 
(RS) 

N VALUE OF ROTATIONAL SPEED AT TIME I (RS) 

DELTAT VALUE OF FAN TOTAL TEMPERATURE RISE FOR 
TIME I (RS) 

CA VALUE OF AMBIENT SPEED OF SOUND FOR 
TIME I (M/S)»(FT/S) (RS) 


HDNFAN 


MODULES 

HDNFAN 


MODULES 

HDNFAN 


MODULES 

IF, PREFAN 
IF,PARAM 
PARAM, 
PREFAN 
PARAM. 
PREFAN 
PARAM. 
PREFAN 
PARAM. 
PREFAN 
PARAM, 
PREFAN 

PREFAN 

PARAM, 

PREFAN 

PARAM. 

PREFAN 

PARAM. 

HDNFAN 

PARAM, 

HDNFAN 

PARAM, 

HDNFAN 

PARAM, 

HDNFAN 

PARAM, 

HDNFAN 
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RHOA VALUE OF AMBIENT DENSITY FOR TIME I 
(KG/M**3),(SLUG/FT**3) (RS) 

SCRNNN INDEX FOR SOURCE MEMBER NAME » I (I) 

STIME VALUE OF SOURCE TIME FOR TIME I (RS) 

MEMBERS - NONE 

FUNCTIONS 

1. LOAD SFIELD DATA UNIT IF NOT ASSIGNED. 

2. EXECUTE PREFAN MODULE TO GET FAN NOISE PARAMETERS. 

3. INITIALIZE SOURCE TIME LOOP. 

4. EXECUTE HDNFAN MODULE FOR EACH SOURCE TIME ON FLI(FLIXXX) 

UNIT MEMBER. ' ' 

MODULES CALLED - PREFAN HDNFAN 

PROCEDURES CALLED - XPREFAN XHDNFAN 

CALLING PROCEDURES - NONE 


PARAM, 

HDNFAN 

PARAM, 

HDNFAN 

PARAM, 

HDNFAN 
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♦•♦♦PROCEDURE TSAESHK 


PURPOSE 




AUTHOR . DSW(L03/00/00) 
DSW(L03/00/05) 
MMF(L03/00/09) 

INPUT 

USER PARAMETERS 


DELTA 

IRATIO 


ITYPE 


lUNITS 


PREPRT 


NENG 

SCRXXX 


5S®!'^^„?EFERENCE area (M**2),(FT**2) 
(RS) (DEFAULT=PI/4. M**2) ^ ^ 

(DFpJSJT^Tf ^ 

INLET ^ND engine 

SPPrTF??^uclSc^l (OEFAULT»0.) 
SPECIFIC HEATS OPTION (A) ' 

8HC0NSTANT - CONSTANT WlO OF SPECIFIC 

BHVA«,AB.E - SAtCPIC 

^ HEATS 

interpolation to be used on the 
engine state tables (I) (0EFAULT=lf 

1 - LINEAR INTERPOLATION ^ 

2 - CUBIC SPLINE INTERPOLATION 
NAUT UNIT OPTION (A) (SEpIi^f-aHSI) 

2HSI - SI UNITS 
7HENGLISH - ENGLISH UNITS 

(I) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

OUTPUT PRINT 

DISTANCE FROM NOZZLE EXIT TO 

iSP 

(OeIaE??.3)’'* 

' bSt'’to “‘^nsionless form 


modules 

PREJET, 

SAESHK 

PREJET 

SAESHK 

PREJET 


PREJET 


PREJET, 

SAESHK 

PREJET 


SAESHK 

SAESHK 

PREJET, 

SAESHK 

SAESHK 
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-3 - OUTPUT PRINT IN DIMENSIONLESS FORM 
AND DB BUT NO TABLE. 

1 - OUTPUT PRINT IN DB AND GENERATE 

SAESHK(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE SAESHK(XXXNNN). 

3 - DUTPUT PRINT IN DIMENSIONLESS FORM 

AND DB AND GENERATE SAESHK(XXXNNN). 
IPRINT OUTPUT PRINT OPTION FOR SAESHK MODULE 
(I) (DEFAULT-3) 

D - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

MEMBERS 

FLI (FLIXXX) - MULTI-RECORD MEMBER OF SOURCE 
TIME DATA. 

ENG (PRIM ) - TYPE 1 DATA TABLE OF THE NOZZLE 
FLOW STATE DATA. 

SFIELD(FREQ ) - ONE RECORD MEMBER OF THE VALUES 
OF FREOUENCY IN HERTZ. 

SFIELD(THETA ) - ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

SFIELD(PHI ) - ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 

OUTPUT 

USER PARAMETERS 

RS RADIAL DISTANCE FROM NOZZLE EXIT TO 
OBSERVER (M),(FT) (RS) 

SAEERR ERROR PARAMETER (I) 

0 - NO ERRORS ENCOUNTERED. 

1 - MEMBER MANAGER ERROR OCCURRED ON OPEN 

2 - INSUFFICIENT LDS AVAILABLE. 

3 - MEMBER MANAGER ERROR OCCURRED ON READ 

4 - AT LEAST ONE USER PARAMETER HAS AN 

INVALID VALUE. 

5 - UNABLE TO BUILD TABLE SAESHK(XXXNNN) . 

6 - AN INVALID VALUE WAS CALCULATED 

DURING EXECUTION. 


SAESHK 


MODULES 

PREJET 

PREJET 

SAESHK 

SAESHK 

SAESHK 

MODULES 

SAESHK 

SAESHK 
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MEMBERS 

SAESHK(XXXOOl) 

SAESHK(XXXNNN) 

LOCAL 

USER PARAMETERS 


NNN TYPE 1 DATA TABLES OF THE 
MEAN-SQUARE ACOUSTIC PRESSURE 
for NNN SOURCE TIMES. 


NTIMES 

I 

TIMES 

ATI 

MTA 

DETl 

OHTl 

MTl 

TTl 

VTl 

RSHTl 

RHOTl 

CTA 

RHOTA 

AJ 
TJ 
VJ 
MJ 

RHOA 
CA 


NUMBER OF SOURCE TIME VALUES (1) 

LOOP INDEX (I) ^ ’ 

multi-element PARAMETER CONTAINING THE 
JET AREA FOR EACH TIME (RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
AIRCRAFT MACH NUMBER FOR EACH TIME (RS) 
'J^LTI-ELEMENT parameter CONTAINING THE 
JET EQUIVALENT DIAMETER FOR EACH TIME (RS) 
parameter CONTAINING THE 
JET HYDRAULIC DIAMETER FOR EACH TIME (RS) 

parameter containing the ^ 

JET MACH NUMBER FOR EACH TIME (RS) 

parameter containing the 

JET TOTAL TEMPERATURE FOR EACH TIME (RS) 

Tr^Jn CONTAINING THE 

JET VELOCITY FOR EACH TIME (RS) 

parameter CONTAINING THE 
RATIO OF SPECIFIC HEATS FOR EACH TIME (RS) 
multi-element PARAMETER CONTaJSJnG THE^ ^ 
JET DENSITY TOR EACH TIME (RS) 

parameter CONTAINING THE 
AMBI^T speed of SOUND FOR EACH TIME 
(M/S).(Fr/S) (RS) 

multi-element parameter CONTAINING THE 
AMBIENT DENSITY FOR EACH TIME (KG/M**3) 
(SLUG/FT**3) (RS) ^ 

VALUE OF JET AREA FOR TIME I (RS) 

VALUE OF JET TEMPERATURE FOR TIME I (RS) 

VALUE OF JET VELOCITY FOR TIME I (RS) 

VALUE OF JET MACH NUMBER FOR TIME I (RS) 

VALUE OF AMBIENT DENSITY FOR TIME I 
(KG/M**3),(SLUG/FT**3) (RS) 

(M/s) ?ft/smrs)^''^^^ ^ 


MODULES 

SAESHK 

MODULE S 

IF, PREJET 
IF, PAR AM 
PREJET, 
PARAM 
PARAM, 
PREJET 
PARAM, 
PREJET 
PREJET 

PREJET 

PARAM, 

PREJET 

PARAM, 

PREJET 

PARAM, 

PREJET 

PREJET 

PREJET 

PARAM, 

PREJET 

PARAM, 

PREJET 

PARAM, 

SAESHK 

PARAM, 

SAESHK 

PARAM, 

SAESHK 

PARAM, 

SAESHK 

PARAM, 

SAESHK 

PARAM, 

SAESHK 
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aircraft MACH NUMBER FOR 

I IMt I (RS) 

SCRNNN INDEX FOR SOURCE MEMBER NAME = I (I) 
STIME VALUE OF SOURCE TIME FOR TIME I (RS) 

MEMBERS - NONE 


PARAM, 

SAESHK 

PARAM, 

SAESHK 

PARAM, 

SAESHK 


FUNCTIONS 


bSS IF NOT ASSIGNED. 

™ "" f-I(FLIXXX) 


MODULES CALLED - PREJET SAESHK 
PROCEDURES CALLED - XPREJET XSAESHK 


CALLING PROCEDURES - NONE 



PROCEDURE PROCLIB ( TS6LJET ) 


♦♦♦♦PROCEDURE TSGLJET 


PURPOSE 


compute the jet exhaust noise 


USING MODULE SGLJET 
INPUT DATA ON AN 


author - DSW(L03/00/00) 
DSW(L03/00/05) 
MMF(L03/00/09) 


INPUT 

USER PARAMETERS 


AE 

AP 

IRATIO 


I type 


lUNITS 


PREPRT 


(r1) 

SPECIFIC HEATS OPTION fAI 
8HC0NSTANT . CONSTANT RATIO OF SPECIFIi 

8HVARIABLE . VwIaBLE^ATIo’oF SPECIFK 
^ HEATS 

OF interpolation to be USED ON THf 

engine state tables (I) (DEFAULT.!? 

1 - LINEAR INTERPOLATION ^ 

2 - CUBIC SPLINE INTERPOLATION 
INPUT UNIT OPTIOMA) (OEFAULT-BHSI) 

7HENGLISH - ENGLISH UNITS 

(l{ (SETOU-Sr"’" 

0 - NO PRINT 


RS 

DELTA 

NENG 

SCRXXX 

I OUT 


- w i rrvin I UHLT 

2 - OUTPUT PRINT ONLY 
J " ®OTH INPUT AND OUTPUT PRINT 
RADIAL DISTANCE FROM NOZZLE EXIT TO 

(WFASalsJ^KA, 

sf-iiss? “ M 

NOISE DATA OUTPUT (I) 

(DEFAULT. 3) ' ^ 

-1 : mISrpR?SI 

■ Burns inSur’" '""ENS'ONEESS form 


MODULES 

PREJET, 

SGLJET 

PREJET 


PREJET 

PREJET, 

SGLJET 

PREJET 


SGLJET 

SGLJET 

SGLJET 

PREJET, 

SGLJET 

SGLJET 
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PROCEDURE PROCLIB ( TSGLJET ) 


-3 - OUTPUT PRINT IN DIMENSIONLESS FORM 
AND OB BUT NO TABLE. 

1 - OUTPUT PRINT IN DB AND GENERATE 

SGLJET(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE SGLJET(XXXNNN) . 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND DB AND GENERATE SGLJET(XXXNNN) . 
IPRINT OUTPUT PRINT OPTION FOR SGLJET MODULE 
(I) (DEFAULT=3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

MEMBERS 


FLI (FLIXXX) - 

ENG (PRIM 

) - 

SFIELD(FREQ 

) - 

SFIELD(THETA 

) - 

SFIELD(PHI 

) - 

SAE (OM 

) - 

SAE (PDF 

) - 

SAE (NDF 

) - 

SAE (MTH 

) - 

SAE (SCJ 

) - 

SAE (SCF 

) - 


MULTI-RECORD MEMBER OF SOURCE 
TIME DATA. 

TYPE 1 TABLE OF THE NOZZLE 
FLOW STATE DATA 

ONE RECORD MEMBER OF THE VALUES 
OF FREQUENCY IN HERTZ. 

ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 

TYPE 1 DATA TABLE OF THE JET 
VARIABLE DENSITY EXPONENT. 

TYPE 1 DATA TABLE OF THE POWER 
DEVIATION FACTOR. 

TYPE 1 DATA TABLE OF THE 
NORMALIZED DIRECTIVITY FUNCTION. 
TYPE 1 DATA TABLE OF THE 
FORWARD VELOCITY INDEX. 

TYPE 1 DATA TABLE OF THE 
SPECTRAL DISTRIBUTION FACTOR. 
TYPE 1 DATA TABLE OF THE 
STROUHAL NUMBER CORRECTION 
FACTOR. 


OUTPUT 

USER PARAMETERS 


RS RADIAL DISTANCE FROM NOZZLE EXIT TO 
OBSERVER (M),(FT) (RS) 


SGLJET 


MODULES 

PREJET 

PREJET 

SGLJET 

SGLJET 

SGLJET 

SGLJET 

SGLJET 

SGLJET 

SGLJET 

SGLJET 

SGLJET 

MODULES 

SGLJET 
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MEMBERS 


MODULES 


SGLJET(XXXOOl) 

SGLJET(XXXNNN) 


- NNN TYPE 1 DATA TABLES OF THE 
MEAN-SQUARE ACOUSTIC PRESSURE 
FOR NNN SOURCE TIMES. 


SGLJET 


LOCAL 

USER PARAMETERS MODULES 


NTIMES 

I 

TIMES 

ATI 

MTA 

DETl 

DHTl 

MTl 

TTl 

VTl 

RSHTl 

RHOTl 

CTA 

RHOTA 

AJ 

RHOJ 

TJ 

VJ 

RHOA 

CA 


NUMBER OF SOURCE TIME VALUES (I) 

LOOP INDEX (I) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
SOURCE TIMES (RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
JET AREA FOR EACH TIME (RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
AIRCRAFT MACH NUMBER FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
JET EQUIVALENT DIAMETER FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
JET HYDRAULIC DIAMETER FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
JET MACH NUMBER FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
JET TOTAL TEMPERATURE FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
JET VELOCITY FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
RATIO OF SPECIFIC HEATS FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
JET DENSITY FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
AMBIENT SPEED OF SOUND FOR EACH TIME 
(M/S), (FT/S) (RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
AMBIENT DENSITY FOR EACH TIME (KG/M**3), 
(SLU6/FT**3) (RS) 

VALUE OF JET AREA FOR TIME I (RS) 

VALUE OF JET DENSITY FOR TIME I (RS) 

VALUE OF JET TEMPERATURE FOR TIME I (RS) 

VALUE OF JET VELOCITY FOR TIME I (RS) 

VALUE OF AMBIENT DENSITY FOR TIME I 
(K6/M**3),(SLUG/FT**3) (RS) 

VALUE OF AMBIENT SPEED OF SOUND FOR TIME I 
(M/S), (FT/S) (RS) 


IF, PREJET 
IF, PAR AM 
PREJET, 
PARAM 
PARAM, 
PREJET 
PARAM, 
PREJET 
PREJET 

PREJET 

PREJET 

PARAM, 

PREJET 

PARAM, 

PREJET 

PREJET 

PARAM , 
PREJET 
PARAM, 
PREJET 

PARAM, 

PREJET 

PARAM, 

SGLJET 

PARAM, 

SGLJET 

PARAM, 

SGLJET 

PARAM, 

SGLJET 

PARAM, 

SGLJET 

PARAM, 

SGLJET 


■j 


i 


i 

i 

I 




.1 



PROCEDURE PROCLIB ( TSGLJET ) 


STIME VALUE OF SOURCE TIME FOR TIME I (RS) 

aircraft MACH NUMBER FOR 

TIME I (RS) 

SCRNNN INDEX FOR SOURCE MEMBER NAME » I (I) 


PAR AM. 
SGLJET 
PARAM, 
SGLJET 
PARAM, 
SGLJET 


MEMBERS - NONE 
FUNCTIONS 


1 . 

2 . 

3 . 

4 . 


LOAD SAE AND SFIELD DATA UNITS IF NOT ASSIGNED 
iS^'uuzT&cTtiSe'^oSp! PARAMETERS 

UNIT^MEMBEpf^ FLI(FLIXXX) 


MODULES CALLED - PREJET SGLJET 
PROCEDURES CALLED - XPREJET XSGLJET 
CALLING PROCEDURES - NONE 


PROCEDURE PROCLIB ( TSMBTUR ) 


♦♦♦♦PROCEDURE TSMBTUR 


PURPOSE 


turbine noise using module SMBTiir 


AUTHOR - DSW(L03/00/00) 
WKB(L03/00/01) 
DSW(L03/00/05) 
MMF(L03/00/09) 

INPUT 

USER PARAMETERS 


AE 

NENG 

RS 

AREA 


NS 

SCRXXX 


I OUT 


IPRINT 


reference area (M**2),(FT**2) 
(DEFAULTER 1/4. M**2) ^ 

NUMBER OF ENGINES (I) (DEFAULT=1) 

'"POM SOURCE TO OBSERVER (M) fFT) 
(RS) (DEFAULT=SQRT(AE)) 

(RSrCOEFA^T^T-''"'®"*' « 

ROTOR BLADE MEAN AXIAL CHORD OF THE 

stages (I) (DEFAULT) 

FLlfn Tvylf^fliS cuES ^9 member NAME 

?]fJ7DEFAULT=3) 

0 - NO PRINT BUT GENERATE SMBTURIXXXNNN^ 

1 - OUTPUT PRINT IN DB BUT NO TABLE 

■ BuTUJ DIMENSIONLESS FORM 

■' ‘ aTdB 

SMBTUR(XXXNNN).^ ^ GENERATE 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

SMBTUR(XXXNNN). 

ST«S5.r »“ -S™’’ 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 


MODULES 

SMBTUR 

SMBTUR 

SMBTUR 

SMBTUR 

SMBTUR 


SMBTUR 

SMBTUR, 

PRETUR 

SMBTUR 


-2 


SMBTUR 
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lUNITS INPUT UNITS OPTION (A) (DEFAULT-2HSI) 

2HSI - SI UNITS 
7HEN6LISH - ENGLISH UNITS 
ITYPE TYPE OF INTERPOLATION TO BE USED ON THE 
ENGINE STATE TABLES (I) (DEFAULT=1) 

1 - LINEAR INTERPOLATION 

2 - CUBIC SPLINE INTERPOLATION 
IRATIO SPECIFIC HEATS OPTION (A) 

8HC0NSTANT - CONSTANT RATIO OF SPECIFIC 
HEATS (DEFAULT) 

8HVARIABLE - VARIABLE RATIO OF SPECIFIC 
HEATS 

PREPRT OUTPUT PRINT CODE FOR PRETUR MODULE 
(I) (DEFAULT=3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 

MEMBERS 

FLI (FLIXXX ) - MULTI-RECORD MEMBER OF SOURCE 
TIME DATA. 

ENG (TUROINEl) - TYPE 1 DATA TABLE OF THE 

TURBINE ENTRANCE FLOW STATE. 

ENG (TURBINE2) - TYPE 1 DATA TABLE OF THE 
TURBINE EXIT FLOW STATE. 

SFIELD(FREQ ) - ONE RECORD MEMBER OF THE VALUES 
OF FREQUENCY IN HERTZ. 

SFIELD( THETA ) - ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

SFIELD(PHI ) - ONE RECORD MEMBER OF THE VALUES 
OF AZIMUTHAL DIRECTIVITY ANGLE 
IN DEGREES. 

OUTPUT 

USER PARAMETERS 

RS DISTANCE FROM SOURCE TO OBSERVER (M),(FT) 
(RS) 


MEMBERS 

SMBTUR(XXXOOl) - NNN TYPE 1 DATA TABLES OF THE 
... MEAN-SQUARE ACOUSTIC PRESSURE 

SMBTUR(XXXNNN) FOR NNN SOURCE TIMES. 


SMBTUR, 

PRETUR 

PRETUR 

PRETUR 

PRETUR 


MODULES 

PRETUR 

PRETUR 

PRETUR 

SMBTUR 

SMBTUR 

SMBTUR 

MODULES 

SMBTUR 

MODULES 

SMBTUR 
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PROCEDURE PROCUB ( TSMBTUR ) 


LOCAL 

USER PARAMETERS 


NTIMES 

I 

TIMES 

MTA 

MTl 

NTl 

TTl 

TT2 

CTA 

RHOTA 

FTA 

HTA 

MA 


NUMBER OF SOURCE TIME VALUES (I) 

LOOP INDEX (I) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
SOURCE TIMES (RS) 

MULTI -ELEMENT PARAMETER CONTAINING THE 
AIRCRAFT MACH NUMBER FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
CORE MASS FLOW RATE FOR EACH TIME (RS) 
PARAMETER CONTAINING THE 
ROTATIONAL SPEED FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
ENTRANCE TOTAL TEMPERATURE FOR EACH TIME 
( 

MULTI-ELEMENT PARAMETER CONTAINING THE 

‘Temperature for each time (rs] 

MULTI-ELEMENT PARAMETER CONTAINING THe' 
ambient SPEED OF SOUND FOR EACH TIME 
(M/S),{FT/S) (RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
AMBIENT DENSITY FOR EACH TIME (KG/M**3). 
(SLU6/FT**3) (RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
FUEL-TO-AIR RATIO FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
ABSOLUTE HUMIDITY FOR EACH TIME (RS) 
AIRCRAFT MACH NUMBER AT TIME I (RS) 


N ROTATIONAL SPEED AT TIME I (RS) 

MDOT CORE MASS FLOW RATE AT TIME T (RS) 


TSJ EXIT STATIC TEMPERATURE AT TIME I (RS) 

CA AMBIENT SPEED OF SOUND AT TIME I (M/S). 

(FT/S) (RS) ^ 

RHOA AMBIENT DENSITY AT TIME I (KG/M**3). 
(SLUG/FT**3) (RS) 

SCRNNN INDEX FOR SOURCE MEMBER NAME * I (I) 
STIME SOURCE TIME VALUE AT TIME I (RS) 

FA FUEL-TO-AIR RATIO AT TIME I (RS) 

HA ABSOLUTE HUMIDITY AT TIME I (RS) 



MODULES 

IF.PRETUR 
IF.PARAM 
PAR AM, 
PRETUR 
PARAM, 
PRETUR 
PARAM, 
PRETUR 
PARAM, 
PRETUR 
PRETUR 


PARAM, 

PRETUR 

PARAM, 

PRETUR 

PARAM, 

PRETUR 

PARAM, 

PRETUR 

PARAM, 

PRETUR 

PARAM, 

SMBTUR 

PARAM, 

SMBTUR 

PARAM, 

SMBTUR 

PARAM, 

SMBTUR 

PARAM, 

SMBTUR 

PARAM, 

SMBTUR 

PARAM, 

SMBTUR 

PARAM, 

SMBTUR 

PARAM, 

SMBTUR 

PARAM, 

SMBTUR 
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MEMBERS . NONE 
FUNCTIONS 

1. LOAD SFIELD DATA UNIT IF NOT ASSIGNED. 

2. EXECUTE PRETIJR MODULE TO GET TURBINE NOISE PARAMETERS. 

3. INITIALIZE SOURCE TIME LOOP. 

4. EXECUTE SMBTUR MODULE FOR EACH SOURCE TIME ON FLI(FLIXXX) 

UNIT MEMBER. ’ 

MODULES CALLED - PRETUR SMBTUR 

PROCEDURES CALLED - XPRETUR XSMBTUR 

CALLING PROCEDURES - NONE 
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PROCEDURE PROCLIB ( TSTNJET ) 


♦♦♦♦PROCEDURE TSTNJET 


PURPOSE 


jet exhaust noise using MODULE 
STATf TABLE^^*^^ PROBLEM WITH INPUT DATA ( 


AUTHOR - DSW{L03/Q0/0S) 
MMF(L03/00/09) 


INPUT 

USER PARAMETERS 


AE 

AP 

IRATIO 


ITYPE 

lUNITS 

PREPRT 


RS 

DELTA 

NENG 

SCRXXX 

I OUT 


ENGINE REFERENCE AREA (M^*2) ,(FT^^2) 
(RS) (DEFAULT=PI/4. M^*2) 

(DEFAULtT^ ^ PLUG area, RE AE (RS) 

SPECIFIC HEATS OPTION (A) 

SHCONSTmNT - CONSTANT RATIO OF SPECIFIC 
HEATS (DEFAULT) 

8HVARIABLE - VARIABLE RATIO OF SPECIFIC 
HEATS 

TYPE OF INTERPOLATION TO BE USED ON THE 
ENGINE STATE TABLES (I) (DEFAULT=1) 

1 - LINEAR INTERPOLATION 

INTERPOLATION 

INPUT UNIT OPTION (A) (DEFAULT=2HSI) 

2HSI - SI UNITS 
7HENGLISH - ENGLISH UNITS 
OUTPUT PRINT OPTION FOR PREJET MODULE 
(I) (DEFAULT=3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

3 - BOTH INPUT AND OUTPUT PRINT 
pipANCE FROM NOZZLE EXIT TO OBSERVER 
(jj) • (PJ) ( RS) ( DEFAULT* SQRT(AE) ) 

VECTOR AND ENGINE 
INLET AXIS (DEGREES) (RS) (DEFAULT=0.) 
NUMBER OF ENGINES (I) (DEFAULT*!) 

MEMBER 

STNJET(XXXNNN) (A) 
(DEFAULT=3HXXX) ' ^ 

CODE FOR NOISE DATA OUTPUT (I) 

(DEFAULT*3) ' ' 

? ‘ b^nerate STNJET(XXXNNN). 

-1 - OUTPUT PRINT IN DB BUT NO TA^E. 

-2 - OUTPUT PRINT IN DIMENSIONAL FORM 
BUT NO TABLE. 


STNJET FOR 
N ENGINE 


MODULES 

PREJET, 

STNJET 

PREJET 

PREJET 

PREJET 

PREJET, 

STNJET 

PREJET 


STNJET 

STNJET 

STNJET 

STNJET 
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-3 - OUTPUT PRINT IN DIMENSIONAL FORM 
AND DB BUT NO TABLE. 

1 - OUTPUT PRINT IN DB AND GENERATE 

STNJET(XXXNNN). 

2 - OUTPUT PRINT IN DIMENSIONLESS FORM 

AND GENERATE STNJET(XXXNNN). 

3 - OUTPUT PRINT IN DIMENSIONLESS FORM 

and DB AND GENERATE STNJETfXXXNNNi 
IPRINT OUTPUT PRINT OPTION FOR STNJET MODULE 
(I) (nEFAULT=3) 

0 - NO PRINT 

1 - INPUT PRINT ONLY 

2 - OUTPUT PRINT ONLY 

m..„ ^ AND OUTPUT PRINT 

plug nozzle plug OPTION (L) (DEFAULT=. FALSE ) 

.TRUE. - CONICAL PLUG NOZZLE 
.FALSE. - NO PLUG 

CIRCLE NOZZLE TYPE OPTION (L) (DEFAULT*. FALSE.) 

.TRUE. - CIRCULAR NOZZLE 
c.mro •f'ALSE. - COAXIAL NOZZLE 
SUPER SHOCK NOISE OPTION (L) (OEFAUET..EALSE.) 
.TRUE. - COMPUTE PRIMART STREAM SHOCK 
NOISE 

.FALSE. - DO NOT COMPUTE 


MEMBERS 


FLl (FLIXXX) 

eng (prim ) 


eng (.sec ) - 


SFIELD(FREQ ) 
SFIELD(THETA ) 


SFIFLD(PHI ) - 


STNT8L(JDF ) . 


STNTBL(SDF ) 


STNTBL(FSP ) . 


MULTI-RECORD MEMBER OF SOURCE 
TIME DATA. 

TYPE 1 DATA TABLE OF THE 
PRIMARY NOZZLE FLOW STATE. 
type 1 DATA TABLE OF THE 
SECONDARY NOZZLE FLOW STATE. 

ONE RECORD MEMBER OF THE VALUES 
OF FREQUENCY IN HERTZ. 

ONE RECORD MEMBER OF THE VALUES 
OF POLAR DIRECTIVITY ANGLE IN 
DEGREES. 

ONE RECORD MEMBER OF THE VALUES 

?N SeT 

TYPE 1 DATA TABLE OF THE JET 
MIXING NOISE SPECTRAL 
DISTRIBUTION FACTOR. 

TYPE 1 DATA TABLE OF THE SHOCK 

noise spectral distribution 

FACTOR. 

type 1 DATA TABLE OF THE 
FREQUENCY SHIFT PARAMETER. 


STNJET 


STNJET 


STNJET 










STNJET 


MODULES 


PREJET 


PREJET 


PREJET 


STNJET 


STNJET 


STNJET 


STNJET 


STNJET 


STNJET 














PROCEDURE PROCUB ( TSTNJET ) 


OUTPUT 

USER PARAMETERS 


MODULES 


RS 


DISTANCE 

(RS) 


FROM SOURCE TO OBSERVER (M),(FT) STNJET 


MEMBERS 


STNJET(XXXOOl) 

STNJET(XXXNNN) 

LOCAL 

USER PARAMETERS 


NNN TYPE 1 DATA TABLES OF THE 
MEAN- SQUARE ACOUSTIC PRESSURE 
FOR NNN SOURCE TIMES. 


NTIMES 

I 

TIMES 

ATI 

MTA 

MTl 

TTl 

VTl 

RSHTl 

RHOTl 

DETl 

DHTl 

CTA 

RHOTA 

AT2 


NUMBER OF SOURCE TIME VALUES (I) 

LOOP INDEX (I) 

ScE'nI!£r(Rsr”"^'' 

MULTI-ELEMENT PARAMETER CONTAINING THE 
PRIMARY JET AREA FOR EACH TIME RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
AIRCRAFT MACH NUMBER FOR EACH TIME IRSI 
MULTI-ELEMENT PARAMETER CONTAINING THE^ 
PRIMARY JET MACH NUMBER FOR EACH TIME 
(RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
PRIMARYsJET total TEMPERATURE FOR EACH 

MULTI-ELEMENT PARAMETER CONTAINING THE 
PRIMARY JET VELOCITY FOR EACH TIME RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
PRIMARYm^ [rRATIO hea?s FOR 

parameter containing the 

PRIMARY JET DENSITY FOR EACH TIME (RS) 
MULTI-ELEMENT PARAMETER CONTAINING THE 
equivalent diameter for EAC! 

IIME (RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
HYDRAULIC DIAMETER FOR EACH 

lIMt (RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 

parameter containing the 

(K/FT«5)'(5sr (W-3), 

MULTI-ELEMENT PARAMETER CONTAINING THE 
SECONDARY JET AREA FOR EACH TIME (RS) 


MODULES 

STNJET 


MODULES 

IF, PREJET 
IF, PAR AM 
PARAM, 
PREJET 
PARAM, 
PREJET 
PARAM, 
PREJET 
PARAM, 
PREJET 

PARAM, 

PREJET 

PARAM, 

PREJET 

PRETET 


PARAM, 

PREJET 

PARAM, 

PREJET 

PARAM, 

PRFJET 

PARAM, 

PREJET 

PARAM, 

PREJET 

PARAM, 

PREJET 
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PROCEDURE PROCLIB ( TSTNJET ) 


MT2 

TT2 

VT2 

RH0T2 

RSHT2 

DET2 

DHT2 

CA 

RHOA 

MA 

A1 

DEI 

OHl 

VI 

RHOl 

T] 

Ml 

A2 

V2 

RH02 

T2 

M2 


MULTI-ELEMENT 
SECONDARY JET 
(RS) 

MULTI-ELEMENT 
SECONDARY JET 
TIME (RS) 

MULTI-ELEMENT 
SECONDARY JET 
MULTI-ELEMENT 
SECONDARY JET 
MULTI-ELEMENT 
SECONDARY JET 
FOR EACH TIME 
MULTI-ELEMENT 
SECONDARY JET 
EACH TIME (RS) 

MULTI-ELEMENT PARAMETER CONTAINING THE 
SECONDARY JET HYDRAULIC DIAMETER FOR 
EACH TIME (RS) 

VALUE OF AMBIENT SPEED OF SOUND FOR 
TIME I (M/S). (FT/S) (RS) 

VALUE OF AMBIENT DENSITY FOR TIME I 
(K6/M**3).(SLUG/FT**3) (RS) 

VALUE OF AIRCRAFT MACH NUMBER FOR 
TIME I (RS) 

VALUE OF PRIMARY JET AREA FOR TIME I 
(RS) 

VALUE OF PRIMARY JET EQUIVALENT DIAMETER 
FOR TIME I (RS) 

VALUE OF PRIMARY JET HYDRAULIC DIAMETER 
FOR TIME I (RS) 

VALUE OF PRIMARY JET VELOCITY FOR TIME I 
(RS) 

VALUE OF PRIMARY JET DENSITY FOR TIME I 
(RS) 

VALUE OF PRIMARY JET TOTAL TEMPERATURE 
FOR TIME I (RS) 

VALUE OF PRIMARY JET MACH NUMBER FOR 
TIME I (RS) 

VALUE OF SECONDARY JET AREA FOR TIME I 
(RS) 

VALUE OF SECONDARY JET VELOCITY FOR 
TIME I (RS) 

VALUE OF SECONDARY JET DENSITY FOR 
TIME I (RS) 

VALUE OF SECONDARY JET TOTAL TEMPERATURE 
FOR TIME I (RS) 

VALUE OF SECONDARY JET MACH NUMBER FOR 
TIME I (RS) 


PARAMETER CONTAINING THE 
MACH NUMBER FOR EACH TIME 

PARAMETER CONTAINING THE 
TOTAL TEMPERATURE FOR EACH 

PARAMETER CONTAINING THE 
VELOCITY FOR EACH TIME (RS 
PARAMETER CONTAINING THE 
DENSITY FOR EACH TIME (RS) 
PARAMETER CONTAINING THE 
RATIO OF SPECIFIC HEATS 
(RS) 

PARAMETER CONTAINING THE 
EQUIVALENT DIAMETER FOR 


PARAM, 

PREJET 

PARAM, 

PREJET 

PARAM, 

PREJET 

PARAM, 

PREJET 

PREJET 


PREJET 


PREJET 


PARAM, 

STNJET 

PARAM. 

STNJET 

PARAM, 

STNJET 

PARAM, 

STNJET 

PARAM, 

STNJET 

PARAM, 

STNJET 

PARAM, 

STNJET 

PARAM, 

STNJET 

PARAM, 

STNJET 

PARAM, 

STNJET 

PARAM. 

STNJET 

PARAM. 

STNJET 

PARAM. 

STNJET 

PARAM, 

STNJET 

PARAM, 

STNJET 


PROCEDURE PROCLIB ( TSTNJET ) 


SCRNNN INDEX FOR SOURCE MEMBER NAME * I (I) 
STIME VALUE OF SOURCE TIME FOR TIME I (RS) 


PARAM, 

STNJET 

PARAM. 

STNJET 


MEMBERS - NONE 
FUNCTIONS 

1. LOAD STNJET AND SFIELD DATA UNITS IF NOT ASSIGNED. 

TO OET JET NOISE PARAMETERS. 

3. INITIALIZE SOURCE TIME LOOP. 

4. EXECUTE STNJET MODULE FOR EACH SOURCE TIME ON FLI(FLIXXX) 

UNIT MEMBER. u.vtuiaaa; 

MODULES CALLED - PREJET STNJET 
PROCEDURES CALLED - XPREJET XSTNJET 
CALLING PROCEDURES - NONE 
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PROCEDURE PROCLIB ( XABS ) 


♦♦♦♦PROCEDURE XABS 

PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE ABS MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 

AUTHOR - DSW(L03/00/00) 

DSW(L03/00/05) 

INPUT 

USER PARAMETERS 
OLD NAME 
IPRINT 
MEMBERS 
OLD NAME 
ATM (TMOD 
OUTPUT 

USER PARAMETERS - SEE ABS MODULE 
MEMBERS 

OLD NAME NEW NAME 

ATM (AAC ) ATMOS (OUTPUT) 

LOCAL - NONE 
MODULES CALLED - ABS 
PROCEDURES CALLED - NONE 
CALLING PROCEDURES - ATMDAT 


NEW NAME 
PRT 

NEW NAME 

) ATMOS (INPUT ) 
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PROCEDURE PROCLIB ( XATM ) 


♦♦♦♦PROCEDURE XATM 

PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE ATM MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 

AUTHOR - DSW(L03/00/00) 

DSW(L03/00/05) 


INPUT 

USER PARAMETERS 

OLD NAME 

IPRINT 

HI 

PI 

DELH 

NHO 

MEMBERS 
OLD NAME 
ATM (IN ) 

OUTPUT 

USER PARAMETERS 
MEMBERS 
OLD NAME 
ATM (TMOD ) 

LOCAL 

USER PARAMETERS 
MEMBERS 
OLD NAME 
SCRATCH (TABl ) 
MODULES CALLED - A 
PROCEDURES CALLED 


NEW NAME 

PRT 

XPl 

XP2 

XP3 

XP4 

NEW NAME 
ATMOS (INPUT ) 

SEE ATM MODULE 

NEW NAME 
ATMOS (OUTPUT) 

NONE 

NEW NAME 
TEMP (TABLE ) 

I 

NONE 


CALLING PROCEDURES - ATMDAT 


PROCEDURE PROCLIB ( XCNLJET ) 


♦♦♦♦PROCEDURE XCNLJET 

PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE CNLJET MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 

AUTHOR - DSW(L03/00/00) 

DSW(L03/00/05) 


INPUT 

USER PARAMETERS 
OLD NAME NEW NAME 

IPRINT PRT 

MEMBERS 


OLD NAME 

SFIELD (FREQ ) 
SFIELD (THETA ) 
SFIELD (PHI 
JWRCOAN(OM 
JWRCOAN(PDF 
JWRCOANfsi 
JWRC0AN(S2 
JWRCOAN(NSF 
JWRCOAN( ALPHA 
JWRCOANfCBF 
JWRCOAN(DIR 
JWRCOAN(MTH 

OUTPUT 

USER PARAMETERS 


NEW NAME 

ARRAY (FREQS ) 
ARRAY (THETAS) 
ARRAY (PHIS 
CNLDATjOMS ) 
CNLDAT(PDFS ) 
CNLDATfSlS ) 
CNLDAT(S2S ) 
CNLDAT(NSFS ) 
CNLDAT(ALPHAS) 
CNLDAT(CBFS ) 
CNLDAT(DIRS ) 
CNLOAT(MTHS 


- SEE CNLJET MODULE 


MEMBERS - NO NAME OVERRIDE REQUIRED FOR CNLJET(XXXNNN) 
LOCAL - NONE 


MODULES CALLED - CNLJET 

PROCEDURES CALLED - NONE 

CALLING PROCEDURES - DCNLJET TCNLJET 


PROCEDURE PROCLIB ( XEFF ) 


♦♦♦♦PROCEDURE XEFF 

PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE EFF MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 

AUTHOR - 0SW(L03/00/00) 

DSW(L03/00/05) 

INPUT 

USER PARAMETERS 

OLD NAME NEW NAME 

IPRINT PRT 

MEMBERS 

OLD NAME NEW NAME 

OBSERVICOORD ) OBS (LOC ) 

LEV (PNLT ) SOUND (LEVELS) 

OUTPUT 

USER PARAMETERS - SEE EFF MODULE 
MEMBERS 

OLD NAME NEW NAME 

EFF (EPNL ) NOISE (EFFECT) 

LOCAL - NONE 
MODULES CALLED - EFF 
PROCEDURES CALLED - NONE 
CALLING PROCEDURES • PROSGL 
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PROCEDURE PROCLIB ( XFNKAFM ) 


♦‘♦PROCEDURE XFNKAFM 


PURPOSE 


- TO PROVIDE ALTERNATE NAME DESIGNATIONS fod tup ihuit 
WMMRS AND PARAHETERS OF THE Sm NODULE 
ALLOWS PROCEDURES TO BE WRITTEN WITH THF samf 
DEFAULT NAMES AS THE ORlS JIooJlE. 


AUTHOR - DSW(L03/00/00) 
DSW(L03/00/05) 


INPUT 

USER PARAMETERS 

OLD NAME 

IPRINT 

MEMBERS 

OLD NAME 

SFIELO(FREQ ) 
SFIELD(THETA ) 
SFIELD(PHI ) 

OUTPUT 

USER PARAMETERS - 
MEMBERS 
LOCAL - NONE 


NEW NAME 
PRT 

NEW NAME 

array (FREQS ) 
array (THETAS) 
array (PHIS ) 

SEE FNKAFM MODULE 

REQUIRED FOR 


- NO NAME OVERRIDE 


FNKAFM(XXXNNN) 


MODULES CALLED - FNKAFM 

PROCEDURES CALLED - NONE 

CALLING PROCEDURES - DFNKAFM TFNKAFM 
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PROCEDURE PROCLIB ( X6EC0R ) 


♦♦♦♦PROCEDURE XGECOR 


PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE GECOR MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 

AUTHOR - DSW(L03/00/00) 

DSW(L03/00/05) 

INPUT 

USER PARAMETERS 
OLD NAME NEW NAME 

IPRINT PRT 

MEMBERS 


OLD NAME 

SFIELDfFREQ ) 
SFIELD(THETA ) 
SFIELD(PHI ) 

OUTPUT 

USER PARAMETERS 


NEW NAME 

ARRAY (FREQS ) 
ARRAY (THETAS) 
ARRAY (PHIS ) 


SEE GECOR MODULE 


MEMBERS - NO NAME OVERRIDE REQUIRED FOR GECOR(XXXNNN) 
LOCAL - NONE 


MODULES CALLED - GECOR 
PROCEDURES CALLED - NONE 


CALLING PROCEDURES • TGECOR D6EC0R 
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PROCEDURE PROCUB ( X6ENSUP ) 


****PROCEDURE XGENSUP 


PURPOSE - 


TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE GENSUP MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 


AUTHOR - DSW(L03/00/05) 


INPUT 

USER PARAMETERS - SEE GENSUP flODULE 


MEMBERS 


OLD NAME new NAME 

NOISE (XXXNNN) UNIT (XXXNNN) 

SUPPRESS( FACTOR) FACT (MULT ) 

OUTPUT 

USER PARAMETERS - SEE GENSUP MODULE 
MEMBERS 


OLD NAME NEW NAME 

NOISES (XXXNNN) UNITS (XXXNNN) 

LOCAL - NONE 

MODULES CALLED - GENSUP 
PROCEDURES CALLED - NONE 
CALLING PROCEDURES - SDLDIR 
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PROCEDURE PROCLIB ( X6ETUR ) 


♦♦♦♦PROCEDURE XGETUR 


PURPOSE 


TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE GETUR MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 


AUTHOR - DSW(L03/00/00) 
DSW(L03/00/05) 


INPUT 

USER PARAMETERS 


OLD NAME NEW NAME 

IPRINT PRT 

MEMBERS 


OLD NAME NEW NAME 

SFIELDIFREQ ) ARRAY (FREQS ) 

SFIELO(THETA ) ARRAY (THETAS) 

SFIELD(PHI ) ARRAY (PHIS ) 

OUTPUT 

USER PARAMETERS - SEE GETUR MODULE 


MEMBERS - NO NAME OVERRIDE REQUIRED FOR GETUR(XXXNNN) 
LOCAL - NONE 


MODULES CALLED - GETUR 
PROCEDURES CALLED - NONE 
CALLING PROCEDURES - DGETUR TGETUR 


PROCEDURE PROCLIB ( X6RA ) 


-♦♦♦♦PROCEDURE XGRA 

PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE INPUT 
AND OUTPUT MEMBERS OF THE GRA MODULE. THIS ALLOWS 
PROCEDURES TO BE WRITTEN USING THE SAME DEFAULT NAMES 
AS THE ORIGINAL MODULE. 

AUTHOR - 0SW(L03/00/00) 

WKB(L03/00/01) 

INPUT 

USER PARAMETERS - SEE GRA MODULE 
MEMBERS - NONE 
OUTPUT 

USER PARAMETERS - SEE GRA MODULE 
MEMBERS 

OLD NAME NEW NAME 

TAB (6E ) GRA (TABLE ) 

LOCAL - NONE 
MODULES CALLED - GRA 
PROCEDURES CALLED - NONE 
CALLING PROCEDURES - NONE 


PROCEDURE PROCLIB ( XHDNFAN ) 


♦♦^♦PROCEDURE XHDNFAN 

PURPOSE - fO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE HDNFAN MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE, 

AUTHOR - DSW(L03/00/00) 

DSW(L03/00/05) 


INPUT 

USER PARAMETERS 

OLD NAME 

IPRINT 

MEMBERS 

OLD NAME 

SFIELD(FREQ ) 
SFIELO(THETA ) 
SFIELD(PHI ) 

OUTPUT 

USER PARAMETERS - 
MEMBERS 
OLD NAME 
HONFAN(XXXNNN) 
LOCAL - NONE 


NEW NAME 
PRT 

NEW NAME 

ARRAY (FREQS ) 
ARRAY (THETAS) 
ARRAY (PHIS ) 

SEE HDNFAN MODULE 

NEW NAME 
HDNNAM(XXXNNN) 


DHDNFAN THONFAN 


MODULES CALLED - HDNFAN 
PROCEDURES CALLED - NONE 
CALLING PROCEDURES - 
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PROCEDURE PROCLIB ( XLEV ) 

★♦♦♦procedure XLEV 

PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE LEV MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 

AUTHOR - DSW(L03/00/00) 

DSW(L03/00/05) 

INPUT 

USER PARAMETERS 

OLD NAME 

IPRINT 

MEMBERS 

OLD NAME 

OBSERV( COORD ) 

SFIELO(FREQ ) 

OUTPUT 

USER PARAMETERS - SEE LEV MODULE 
MEMBERS 

OLD NAME NEW NAME 

LEV (PNLT ) NOISE(LEVELS) 

LOCAL - NONE 
MODULES CALLED - LEV 
PROCEDURES CALLED - NONE 
CALLING PROCEDURES - PR0S6L 


NEW NAME 
PRT 

NEW NAME 

OBS (LOC ) 
FREQU (ARRAY ) 
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PROCEDURE PROCUB ( XPREAFM ) 


♦♦♦♦PROCEDURE XPREA* il 


PURPOSE 


TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
Members AND PARAMETERS of the preafm module, this 
ALLOWS procedures TO BE WRITTEN WITH THE SAME 
nFFAlIlT NAMES AS THE ORIGINAL MODULE. 


AUTHOR - DjW(L03/00/00) 
DSW(L03/00/05) 
MMF(L03/00/09) 


INPUT 

USER PARAMETERS 
OLD NAME 
IPRINT 
MEMBERS 
OLD NAME 
FLI (FLIXXX) 
OUTPUT 

USER PARAMETERS - 


NEW NAME 
PRT 

NEW NAME 
FLIGHT(FLIXXX) 

SEE PREAFM MODULE 


MEMBERS - NONE 


LOCAL - NONE 
MODULES CALLED - PREAFM 
PROCEDURES CALLED - NONE 
CALLING PROCEDURES - TFNKAFM 
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PROCEDURE PROCLIB ( XPRECOR , 


★♦♦♦procedure XPRECOR 

PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE PRECOR MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 


- DSW(L03/00/00) 
0SW(L03/00/05) 


AUTHOR 

INPUT 
USER PARAMETERS 

OLD NAME 

IPRINT 

MEMBERS 

OLD NAME 

FLI (FLIXXX) 
ENG (COREl ) 

ENG (CORE2 ) 

OUTPUT 

USER PARAMETERS 
MEMBERS - NONE 


NEW NAME 
PRT 

NEW NAME 

FLIGHT(FLIXXX) 
ENGINE (COR IN ) 
ENGINE(COROUT) 

SEE PRECOR MODULE 


LOCAL - NONE 
MODULES CALLED - PRECOR 
PROCEDURES CALLED - NONE 
CALLING PROCEDURES - TGECOR 
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PROCEDURE PROCLIB ( XPREFAN ) 


jt 


♦♦♦♦procedure XPREFAN 

PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE PREFAN MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 


AUTHOR - DSW(L03/00/00) 

OSW L03/00/05) 
MMF(L03/00/09) 

INPUT 

USER PARAMETERS 
OLD NAME NEW NAME 


IPRINT PRT 


MEMBERS 

OLD NAME 

FLI (FLIXXX) 
ENG (FANl ) 

ENG (FAN2 ) 


NEW NAME 

FLIGHT(FLIXXX) 
EN6INE(FANIN ) 
ENGINE(FANOUT) 


OUTPUT 

USER PARAMETERS - SEE PREFAN MODULE 


MEMBERS - NONE 


LOCAL - NONE 
MODULES CALLED - PREFAN 
PROCEDURES CALLED - NONE 
CALLING PROCEDURES - THDNFAN 
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♦♦♦♦PROCEDURE XPREJET 

PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE PREJET MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 

AUTHOR - DSW(L03/00/00) 

DSW(L03/00/05) 



INPUT 

USER PARAMETERS 


OLD NAME 

NEW NAME 

IPRINT 

PRT 

MEMBERS 


OLD NAME 

NEW NAME 

FLI (FLIXXX) 
ENG (PRIM ) 

ENG (SEC ) 

FLIGHT(FLIXXX) 
ENGINE (ONE ) 
ENGINE(TWO ) 

OUTPUT 

USER PARAMETERS - 

SEE PREJET MODULE 

MEMBERS - NONE 


LOCAL - NONE 



MODULES CALLED - PREJET 


PROCEDURES CALLED - NONE 

CALLING PROCEDURES - TCNLJET TSAESHK TSGLJET TSTNJET 


PROCEDURE PROCLIB ( XPRETUR ) 


****PROC j,<E XPRETUR 

PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE PRETUR MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 

AUTHOR - DSW(L03/00/00) 

DSW(L03/00/05) 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS 


OLD NAME 

NEW NAME 

IPRINT 

PRT 

MEMBERS 


OLD NAME 

NEW NAME 

FLI (FLIXXX) 
ENG (TURBINEl) 
ENG (TURBINE2) 

FLIGHT(FLIXXX) 
ENGINE(TURIN ) 
ENGINE(TUROUT) 

OUTPUT 

USER PARAMETERS - SEE 

PRETUR MODULE 


MEMBERS - NONE 
LOCAL - NONE 
MODULES CALLED - PRETUR 
PROCEDURES CALLED - NONE 
CALLING PROCEDURES - TGETUR TSMBTUR 
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PROCEDURE PROCLIB ( XPRO ) 


♦♦♦♦PROCEDURE XPRO 

PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE PRO MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 

AUTHOR - DSW(L03/00/00) 

DSW{L03/00/05) 


INPUT 

USER PARAMETERS 


OLD NAME 

NEW NAME 

PROSUM 

IPRINT 

PRONAM 

PRT 

MEMBERS 


OLD NAME 

NEW NAME 

ATM (TMOD ) 
ATM (AAC ) 
GEO (GEOM ) 
FLI (FLIXXX) 

ATMOS (DATA 
ATMOS (ABSORP 
OBS ^-FCTOR 
FLIGHT ^FLIXXX 

OUTPUT 

USER PARAMETERS - 

SEE PRO MODULE 

MEMBERS 


OLD NAME 

NEW NAME 

PRO (PRES ) 

NOISE (SPEC 


LOCAL - NONE 
MODULES CALLED - PRO 
PROCEDURES CALLED • NONE 
CALLING PROCEDURES - PROSGL 
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PROCEDURE PROCLIB ( XPROSGL ) 


****PROCEDURE XPROSGL 

PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF PROCEDURE PROSGL. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL PROCEDURE. 

AUTHOR - DSW(L03/00/00) 

DSW(L03/00/05) 

MMF(L03/00/09) 

INPUT 

USER PARAMETERS 


OLD NAME 


NEW NAME 


PROSUM PRONAM 

IPRINT PRT 


MEMBERS 


OLD NAME 


NEW NAME 


ATM (TMOD ) 
ATM (AAC ) 
GEO 6E0M ) 
FLI (FLIXXX) 
FLI (PATH ) 
OBSERV( COORD ) 
SFIELD(FREQ ) 


ATMOS (DATA ) 
ATMOS (ABSORP) 
OBS (VECTOR) 
FLIGHT(FLIXXX) 
flight! TRAJ ) 
OBSER (LOC ) 
FREQU (ARRAY ) 


OUTPUT 

USER PARAMETERS • UNCHANGED 


MEMBERS 

OLD NAME NEW NAME 

PRO (PRES ) NOISl (SPEC ) 

LEV (PNLT ) NOIS2 (LEVELS) 

EFF EPNL ) N0IS3 (EFFECT) 

SAELAT(EPNL ) N0IS4 (EFFECT) 

LOCAL - NONE 

MODULES CALLED - EFF LEV PRO SAELAT 


PROCEDURES CALLED - PROSGL XEFF XLEV XPRO XSAELAT 
CALLING PROCEDURES - PROMUL 
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PROCEDURE PROCUB ( XSAESHK ) 

1 


♦♦♦★procedure XSAESHK 


PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE SAESHK MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 

AUTHOR - DSW(L03/00/00) 

OSW(L03/00/05) 


INPUT 

USER PARAMETERS 
OLD NAME 
IPRINT 


NEW NAME 
PRT 


MEMBERS 

OLD NAME 

SFIELDIFREQ ) 
SFIELD(THETA ) 
SFIELD(PHI ) 


NEW NAME 

ARRAY (FREQS ) 
ARRAY (THETAS) 
ARRAY (PHIS ) 


OUTPUT 

USER PARAMETERS - SEE SAESHK MODULE 

MEMBERS - NO NAME OVERRIDE REQUIRED FOR SAESHK(XXXNNN) 


LOCAL - NONE 

MODULES CALLED - SAESHK 

PROCEDURES CALLED - NONE 

CALLING PROCEDURES - TSAESHK DSAESHK 
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PROCEDURE PROCLIB ( XSGUET ) 


★♦♦♦procedure XSGUET 

PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE SGLJET MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 

AUTHOR - DSW(L03/00/00) 

DSW(L03/00/05) 

INPUT 

USER PARAMETERS 

OLD NAME 

IPRINT 

MEMBERS 

OLD NAME 

SFIELO(FREQ 
SFIELO(THETA 
SFIELD(PHI 
SAE (MTH 
SAE (PDF 
SAE (NOF 
SAE (SCF 
SAE (OM 
SAE (SJC 

OUTPUT 

USER PARAMETERS - SEE SGLJET MODULE 
MEMBERS - NO NAME OVERRIDE REQUIRED FOR SGLJET(XXXNNN) 

LOCAL - NONE 
MODULES CALLED - SGLJET 
PROCEDURES CALLED • NONE 
CALLING PROCEDURES - TSGLJET DS6LJET 


NEW NAME 
PRT 


NEW NAME 

) ARRAY (FREQS ) 
) ARRAY (THETAS) 
) ARRAY (PHIS ) 
) SAEDAT(MTHTMP) 
) SAEDAT(PDFTMP) 
) SAEDAT(NDFTMP) 
) SAEDAT(SCFTMP) 
) SAEDAT( OMTMP) 
) SAEDAT(SJCTMP) 
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PROCEDURE PROCLIB ( XSMBTUR ) 


♦♦♦♦PROCEDURE XSMBTUR 


PURPOSE 


- TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE SMBTUR MODULE. THIS 

WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 


AUTHOR - 0SW(L03/00/00) 
DSW(L03/00/05) 


INPUT 

USER PARAMETERS 


OLD NAME new NAME 


IPRINT PRT 


MEMBERS 


OLD NAME NEW NAME 


SFIELD(FREQ 

SFIELO(THETA 

SFIELD(PHI 


ARRAY (FREQS ) 
ARRAY (THETAS) 
ARRAY (PHIS ) 


OUTPUT 

USER PARAMETERS - SEE SMBTUR MODULE 


MEMBERS - NO NAME OVERRIDE REQUIRED FOR SMBTUR(XXXNNN) 
LOCAL - NONE 


MODULES CALLED - SMBTUR 

PROCEDURES CALLED - NONE 

CALLING PROCEDURES - DSMBTUR TSMBTUR 


PROCEDURE PROCLIB ( XSTNJET ) 




••♦♦PROCEDURE XSTNJET 


PURPOSE - TO PROVIDE ALTERNATE NAME DESIGNATIONS FOR THE UNIT 
MEMBERS AND PARAMETERS OF THE STNJET MODULE. THIS 
ALLOWS PROCEDURES TO BE WRITTEN USING THE SAME 
DEFAULT NAMES AS THE ORIGINAL MODULE. 

AUTHOR - DSW(L03/00/0S) 


INPUT 

USER PARAMETERS 

OLD NAME 

IPRINT 

MEMBERS 

OLD NAME 

SFIELD(FREQ ) 
SFIELDfTHETA) 
SFIELD(PHI ) 
STNTBL(JOF ) 
STNTBL(SOF ) 
STNTBL(FSP ) 

OUTPUT 

USER PARAMETERS - 


NEW NAME 
PRT 


NEW NAME 

ARRAY (FREQS ) 
ARRAY (THETAS) 
ARRAY (PHIS ) 
STNDATfJDFS ) 
STNDAT(SOFS ) 
STNOAT(FSPS > 


SEE STNJET MODULE 


MEMBERS > NO NAME OVERRIDE REQUIRED FOR STNJET(XXXNNN) 
LOCAL - NONE 


MODULES CALLED - STNJET 
PROCEDURES CALLED - NONE 


CALLING PROCEDURES - OSTNJET TSTNJET 
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6 ANOPP PERMAMBNl DATA BASK 


6,1 OVERVIEW 


•ttia nolaa pradlctlon methods used in ANOPP are larqaly empirical and 
racfulra tablaa of data that are used durinq execution. In order to provide 
an efficient method of handling these tables the ANOPP permanent data base 
was developed* In addition to the data required by the functional modules, 
Htandard tables of output data are available to substitute for the func- 
tional modules vfhich created them* flse of these tables would reduce costs* 
itie ANOPP procedure library is available and should be used when possible i 
however, there may be cases where the standard procedures are not suffi- 
cient* For efficiency, additional user data and procedures can and should 
bo maintained with the ANOPP data base management system* Ihere are at 
present many user-defined data bases that are available to the ANOPP user* 
For information concerning the user data bases the ANOPP user is referred to 
the specific application* 


6.2 ANOPP PERMANENT DATA BASE DESCRIPTIONS 

Tbe following table describes the data available at the time of publi- 
cation of this manual. It describes the data available for Level 03/00/00. 


Data unit 

Data mambar 

Description 

ATMOS 

ABS 

Data table of atmospheric absorption for 

ANSI standard absorption method^ at standard 
conditions as output by PM ABS# 

ATMOS 

SAEABS 

Data table of atmospheric absorption for SAE 
ARP 866A” method at standard conditions as 
output by PM ABSe 

ATMOS 

STRD 

Data table of atmospheric model data for 

standard conditions as required for input to 
PM ABS. 

ICAOSAE 

NTH 

Data table of forward valooity index aa a 
function of directivity angle in degrees aa 
described in appendix A of ARP 876.^ 

ICAOSAE 

NDP 

Data table of common logarithms of the 

normalised directivity function for circular 
jets aa described in appendix A of ARP 876.^ 

ICAOSAE 

ON 

Data table of jat variable density einonent as 
described in appendix A of ARP 876.° 

ICAOSAE 

PDF 

Data table of common logarithms of the power 
deviation factor as described in appendix A of 
ARP 876.° 

ICAOSAE 

SCP 

Data table of Strouhal maiber correction factor 
as described in appendix A of ARP 876.° 


^Reference 3. 
Reference 4. 
^Referanoe 5. 
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Data unit 

Data member 

Description* 

ICAOSAE 

SJC 

Data table of normalized spectral distribution 
factor as described in appendix A of ARP 876*^ 

JWRCOAN 

ALPHA 

Table of 
number 

common logarithms of the peak Strouhal 
as described in section 4.8.7. 

JWRCOAN 

CBF 

Table of overall power level benefit for 
coannular nozzle as described in 
section 4«8*7w 

JWRCOAN 

DIR 

Table for 10 times the comir.on logarithms of 
normalized directivity function for coannular 
jets as function of directivity angle and 
common logarithms of ratio of jet velocity to 
speed of sound as described in section 4«8«7. 

JWRCOAN 

MTH 

Table of forward flight effect correction as a 
function of directivity angle in degrees. 

JWRCOAN 

NSP 

Table of common logarithms of normalized 
spectrum function as function of common 
logarithm of Strouhal number and direc* 
tivity angle in degrees. 

JWRCOAN 

OM 

Table of jet variable density exponent as 

function of common logarithm of ratio of jet 
velocity to speed of sound as described in 
section 4.8.7. 

JWRCOAN 

PDF 

Table of common logarithms of power deviation 
factor of SAB method as described in 
section 4.8.7. 

JWRCOAN 

1 

S1 

Table of common logarithms of peak Strouhal num- 
ber for first component of spectrum as func- 
tion of directivity angle and common loga- 
rithm of ratio of jet velocity to speed of 
sound as described in section 4.8.7. 

JWRCOAN 

S2 

Table of peak Strouhal number for second com- 
ponent of spectrum as function of directivity 
angle and common logarithm of ratio of jet 
velocity to speed of sound as described in 
section 4.8.7. 

PROCLIB 

ATMDAT 

See section 5.2. 

PROCLIB 

ATMSTD 



PROCLIB 

DCNLJET 



PROCIilB 

DFNKAFM 



PROCLIB 

OGECOR 



PROCLIB 

DGETU'^ 






®Ref#»rencG 5« \ 
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Data unit 


Data mamber 


Deacrlptlon 


PROCLIB 

DHDNFAN 

PROCLIB 

DSAGSHK 

PROCLIB 

OSGLJET 

PROCLIB 

DSMBTUR 

PROCLIB 

DSTN JET 

PROCLIB 

LISTALL 

PROCLIB 

LISTONE 

PROCLIB 

PROMOL 

PROCLIB 

PROSGL 

PROCLIB 

TCNLJET 

PROCLIB 

TPNKAPM 

PROCLIB 

TGBCOR 

PROCLIB 

TGETUR 

PROCLIB 

THDNPAN 

PROCLIB 

TSAESHK 

PROCLIB 

TSGLJET 

PROCLIB 

TSMBTUR 

PROCLIB 

TSTNJET 

PROCLIB 

XABS 

PROCLIB 

XATM 

PROCLIB 

XCNLJET 

PROCLIB 

XEPP 

PROCLIB 

XFNKAFM 

PROCLIB 

XGECOR 

PROCLIB 

XGENSUP 

PROCLIB 

XGETUR 

PROCLIB 

XGRA 

PROCLIB 

XHDNPAN 

PROCLIB 

XLEV 

PROCLIB 

XPREAFM 

PROCLIB 

XPRECOR 

PROCLIB 

XPREPAN 

PROCLIB 

XPREJET 
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OatA unit 

Data member 

Description 

PROCLIB 

XPRETUR 

See section 5«2. 

PROCLIB 

XPRO 



PROCLIB 

XPROSGL 



PROCLIB 

XSAESHK 



PROCLIB 

XSGLJET 



PROCLIB 

XSNBTUR 



PROCLIB 

XSTNJET 


f 

SAE 

MTH 

Table of forward- velocity index as a function 
of directivity angle in degrees. 

SAE 

NDF 

Table of common logarithms of normalized 
directivity function for circular jets as a 
function of (1) directivity angle in degrees 
and (2) common logarithm of ratio of jet 
velocity to speed of sound. 

SAB 

OM 

Table of jet variable -density exponent as 
function of common logarithms of ratio of 
jet velocity to speed of sound. 

SAE 

PDF 

Table of common logarithms of power deviation 
factor from V® law as a function of common 
logarithm of ratio of jet velocity to speed of 
sound. 

SAE 

SCF 

Table of Strouhal number correction factor as 
a function of ratio of jet velocity to speed 
of sound and directivity angle. 

SAB 

SJC 

Table of normalized spectral distribution 
factor as a function of <1) common logarithm 
of corrected Strouhal number, (2) ratio of jet 
velocity to speed of sound, (3) directivity 
angle from jet inlet in degrees, and (4) ratio 
of jet temperature to ambient temperature. 

S FI ELD 

FREQ 

Data member containing 1 /3-octave-band center 
frequencies from 50 Hz to 10 kHz. 

SFIELD 

PHI 

Data member containing azimuthal directivity 
angle in degrees most cotrattonly used. It 
contains only one value, zero. 

SFIELD 

THETA 

Data member containing polar directivity angles 
in degrees most commonly used. It contains 
the values from 20® to 170® in 10® increments. 

STNTBL 

FSP 

Data table containing frequency shift parameter 
as described in section 4.8.6. 

STNTBL 

SDF 

Data table containing shock noise spectral 
distribution factor as described in 
section 4.8.6* 

STNTBL 

JDF 

Data table of jet mixing noise spectral 
distribution factor as described In 
section 4.8«6. 
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glossa' *.' o p anopp terms and acronyms 

A.1 TERMS 

Alternate names - 'Bie set of names , established on the EXECUTE control 

statement, which corresponds to a set of reference names. 
Hie set of alternate names is available for retrieval by a 
functional or an executive system module during the execu- 
tion of that module. 

ANOPP run - One execution of ANOPP, the sequence of actions defined by a 
user's card-image primary input stream. 

Archive - Hie read-only status, established with the ARCHIVE control state- 
ment, whereby the future generation of additional members on a 
specified data unit is prohibited. 

Checkpoint run - An ANOPP run during which a checkpoint file is built. Bach 
cycle generated on the file preserves a run operating envi- 
ronment that may be reestablished during the initiation of 
a subsequent restart run. 

Control statement (CS) - One or more card images which define a particular 

action to be performed by the executive system 
during an ANOPP run. 

DATA - Hie name of the data unit created by the ANOPP executive system and 
used to store data members created with DATA control statements 
encountered in the primary input stream. 

Data base - A collection of data units residing on random-access mass- 

storage files or sequential library files. (See permanent data 
base, run-life data base, and user's data base.) 

Data element - On*: or mere wrds residing on a formatted data record. Its 
data type and number of viords are determined by the corre- 
“..oonding element code in the member format. 

Data member - Any member other than a procedure member or a table member. 
(See member.) 

Data record - An ordered set of data elements or words residing on a member. 

The record may be unformatted or it may be formatted as fixed, 
variable, or card image according to the member format. 

Data table - A table of data available to the f i, stional module for process- 
ing. It resides on a one-record member having an internal 
format corresponding to a defined data table type. 

Data unit - Hie highest level of the ANOPP data base structure that can be 
referenced directly (by name) during an ANOPP run. It is a set 
of named numbers and it resides alone on an external random- 
access mass-storage file. 
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Data unit directory (DUD) - “nie executive system directory containing an 

entry for each data unit currently established 
in a run, that is, the run-life data base. 

Delimiter - A character on a control statement card image that terminates a 
field. Special delimiters may constitute a single-character 
field. The comma and space are valid delimiters on all control 
statements. Specific control statements allow or reguire the 
use of the following special delimiter characters: ( ) = / 

* and ; . 

Element - A word or group of words on a record. (See data element.) 

Element code - The descriptor within a data member format specification used 
to identify the data type of an element within the data mem- 
ber's records. 

Established data unit - A run-life data unit. 

Sjtablished file - A rotating mass-storage file or tape file assigned to the 

user's job in the external system. 

Executive system - The ANOPP modules that manage the seguence of processing 

during a run based on the user's control statement 
streams. 

External control card - The card-image directives required by the external 

system to define and execute a job on the host 
computer. 

External file - A file residing on magnetic tape or on rotating mass-storage 
devices under the management of the external system. 

External system - Ihe operating system that control? all job processing on 
the host computer. 

Functional module (PM) - A named set of one or more modules recognized by 

the ANOPP executive system that performs a specific 
utility or noise prediction taslc. A functional 
module xa called into execution during a run with 
an EXECUTE control statement. 

Global dynamic storage (GDS) - A section of free core storage defined and 

maintained by the executive system for stor- 
age of directories and tables. It resides at 
the end of a user's job field throughout the 
life of an ANOPP run. Storage size is con- 
trolled by an initialization parameter that 
may be assigned a value with the ANOPP con- 
trol statement or the RSTRT control 
statement. 
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Initialization parameter - Run control parameter maintained by the executive 

system and used to initialize an ANOPP run's 
operating environment. The user may assign 
values with an ANOPP control statement or with 
the RSTRT control statement in a restart run. 

Input stream - A set of control statements that defines a sequence of 

actions to occur during an ANOPP run. (See primary input 
stream and secondary input stream.) 

Inserted primary input stream - A control statement stream optionally 

inserted and executed in a restart run. 

(See primary input stream.) 

Job dec)c > The entire card-image dec)c (or file) consisting of the external 
control cards and primary input stream(s) required to execute an 
ANOPP job. 

Library file - See sequential library file. 

Local dynamic storage (LDS) - A section of free core storage maintained by 

the executive system that begins with the word 
following the longest segment currently being 
executed and ends at the start of global 
dynamic storage. 

Member - Ihe lowest level of the ANOPP data base structure that can be 

referenced directly (by name) during an ANOPP run. It is a logi- 
cally contiguous set of records and it resides on a data unit. 

Member format - A specification which describes the composition of data 
records residing on a member. 

Module - A FORTRAN or COMPASS subprogram that is part of the ANOPP system. 

Parameter - See initialization parameter, system parameter, and user 
parameter. 

Permanent data base - Ihe collection of data unit files and sequential 

library files established, maintained, and installed 
as part of the ANOPP system. 

Permanent file - An external file established permanently at the host com- 
puter installation. 

Primary edit phase - The section of an ANOPP run when the primary input 

stream is checiced for correct syntax. Continuation of 
the run depends on successful completion of this phase} 
otherwise, an error message is written and the run is 
terminated. 

Primary input stream - The control statement card deck or card-image file 

required as input to each ANOPP run. 
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Procedure member - A member containing a set of card-image records called a 

secondary input stream. Each record 1-, a valid control 
statement card image. (See secondary input stream.) 


Random-access file - 


■Bie type of external mass-storage file required as the 
residence of an ANOPP run-life data unit, it allows 
the direct addressing of the unit's members. 


Record - to ordered set of elements or words residing on a member, 
data record.) 


'■;^e 


Restart run - to ANOPP run in which the RSTRT control statement i, the first 
control statement in the primary input stream. At run initia- 
tion, the operating environment that existed in a previous 
ANOPP run and was preserved on an external oheo)cpoint file is 
reestablished. 

Run-control parM.t.r - to inltUUMtion or p.r«n.ter Mlntalood by 

the executive system and used to control operating 
environment during an ANOPP run. 


Run-life data base - All data units established in an ANOPP run at a given 

point in time. Bach unit resides on a separate exter- 
nal random-access file and has an entry in the data 
unit directory. 

Run-life data unit - A data unit currently established in the run-life da. 

base. 


Run-life member - A member residing on a run-life unit. 


Scratch file 


A temporary file on which a data unit or library that 
exist only during the current ANOPP job or run 
established. 


secondary edit phase - The section of an ANCT ? run when the secondary input 

stream is checked for correct syntax. Continuation 
of the run depends on successful completion of this 
phase; otherwise, an error message is written and the 
run is terminated. 

S,oond.ty input - » ,« of „Ud control .t«t.m.nt. th.t on . 

card-image procedure member and to which run pro- 
cessing control may be temporarily transferred via 
the execution of the CALL control statement. 

S«,u.ntl.l library til. - » a.,u.ntl,l flla (tap. or masa-.torag.) on «,lch 

nufifn ™-lit« <iata units are stored with an 
UNLOAD control statement and from which run-life 
data units may subsequently be generated with a 
LOAD control statement* 
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Run control parameter maintained by the executive system 
used to control characteristics of an ANOPP run’s opera - 
inq environment. They may be assigned new values repea 
edly during a run with the SETSYS control statement. 
Several system parameters may also be assigned initial 
values with the ANOPP control statement (or RSTRT control 
statement in restart runs). 

Table member - A member containing a one-record member corresponding to a 
defined data table type. 


User parameter 


Array more values which, once established, 

remaim . r: ; *able to the user throughout the ANOPP run. 

The value (s) c-c a user parameter may be established or 
changed via tiie PARAM control statement, the EVALUATE 
control stateir nt, or during the execution of a functional 
modu’^. The valne(s) of a user parameter may be retrieved 
duri ' c unctional module processing and may be tested by 
the us.^i with the IF control statement. 


User parameter table (UPT) - 


A table built and maintained by the executive 
system which links the user parameter name with 
its current value, type, and number of 
elements. 


User's 

data base - The collection of data unit files 

files established and maintained by the user at the host 

computer installation. 

I 

t 

1 

XRUNIT 

- A data unit created on a scratch file by the ANOPP executive sys- 
tem. It is used during checkpoint, and restart ruas^ 


XSUNIT 

- A data unit created on a scratch file by the ANOPP executive sys- 
tem. It is reserved for ANOPP executive system usage. 

■j 

•I 


A. 2 ACRONYMS 

J 

i 

ANOPP 

Aircraft Noise Prediction Program 


CS 

control statement 


DUO 

data unit directory 

i 

1 

EPNL 

effective perceived noise level 

1 

PM 

functional module 


CDS 

global dynamic storage 


LDS 

local dynamic storage 

i 

i 

i 

OASPL 

overall sound pressure It 

i 

•i 

PNL 

perceived noise level 

4 
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PNLT tona-corracted parcel vad noise level 

SPL sound pressure level 

UPT user parameter table 
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CONTROL STATEMENT INDEX 


Control statement name 


Section 


ANOPP 

ARCHIVE 

ATTACH 

CALL 

CATALOG 

CKPNT 

CONTINUE 

CREATE 

DATA 

DETACH 

DROP 

ENDCS 

EXECUTE 

EVALUATE 

GOTO 

IP 

LOAD 

MEMLIST 

PAR2V4 

PROCEED 

PURGE 

RSTRT 

SETSYS 

STARTCS 

TABLE 

TABLIST 

TITLE 

UNLOAD 

UPDATE 

UPLIST 


3.1 .3.2 

3.5.3 

3.5.1 .1 

3.9.2 

3.5. 2.1 

3.10.2 

3.8.4 

3.5.1 .2 

3.7.2 

3. 5. 1.3 

3.6.3 

3.1 .4.1 .2 

3.4.2 

3.3.3 

3.8.2 

3.8.3 

3.6.1 

3. 5. 2. 2 

3.3.2 

3.8.5 

3.5.1 .4 

3.10.3 

3.2.2 

3.1 .4.1 .1 

3.7.3 

3.5. 2. 3 

3.2.3 

3.6.2 

3.7 .4.2 

3.3.4 


B“1 



APPENDIX C 


ERROR DIAGNOSTICS AND RECOVERY TECHNIQUES 
C,1 INTRODUCTION 

Error maaaagaa ganerated during an ANOPP job can be any one of the 
following] 

1 . An external ayatem diagnostic 

2. An ANOPP functional module error message 

3. An ANOPP executive system diagnostic 

The diagnostics produced by the external operating system that concern 
the user are usually fatal# resulting in job termination* They often relate 
to an error condition previously reported by ANOPP messages In the same 
job. If an ANOPP run recovery technique (discussed below) is not appropri- 
ate# the user may require either local computer site assistance or personal 
knowledge of the host operating system. Ihe applicable section of appen- 
dix D covers the user's host computer operating system and includes a list 
of the manuals required for interrogation of external system diagnostics. 

Error messages produced by specific functional modules are documented 
in section 4. They report the occurrence of a condition meaningful to the 
noise prediction or utility function of the executing module. Errors pro- 
duced by functional modules are nonfatal and result in subsequent run pro- 
cessing (following termination of the PM) being under the control of the 
JCON system parameter. (See section 3.2.) Recovery techniques discussed 
below for ANOPP executive system diagnostics are also applicable for many 
FM-produced error messages. 


C.2 ANOPP EXECUTIVE SYSTEM DIAGNOSTICS 

The major executive subsystems that control ANOPP run initialization, 

CS editing# and CS and FM processing phases produce diagnostics. They 
report fatal errors resulting in run termination and nonfatal errors result- 
ing in the current value of the JCON system parameter controlling subsequent 
run processing* 

All ANOPP executive system diagnostics have the following general form: 

prefix (ERROR NlMBBR v) *** (CALLER sysrtn) error message 

where prefix identifies the executive subsystem that produced the diagnos- 
tic# V 1s the number of the specified system error# sysrtn is the system 
subroutine that called the error processor# and error message is the 
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error condition that occurred. The diagnostics prefixes and the executive 
subsystems that produce them ares 



EXRC 

ERROR 


th« 

executive management eyetem 


DBM 

ERROR 

- 

the 

data ba«e management (DBM) member 


LOAD 

ERROR 


the 

DBM LOAD CB proceanor 

*** 

UNLOAD 

ERROR 

- 

the 

DBM UNLOAD CS proces 3 or 

*** 

DTM 

ERROR 

- 

the 

table manager ayatem 


XTB 

ERROR 

- 

the 

table manager eyetem uttlltleH 

*** 

DBM 

ERROR 

- 

the 

dynamic ntorage manager 

Him 

UPDATE 

ERROR 

- 

the 

UPDATE CS proceenor 


UTILITY 

ERROR 

- 

the 

internal system utilities 

*#* 

EVALUATE 

ERROR 

- 

the 

evaluate CS processor 


Most error messages the normal ANOPP user encounters relate to a spe- 
cific condition that the user can correct through changes to his ANOPP run 
input control statements and/or to his external control cards. However, 
some error messages are applicable to internal execution problems. These 
are meaningful to and require the attention of a programmer maintaining the 
ANOPP system or a specific functional module. The following table lists the 
executive system diagnostics and suggests recovery techniques to be used: 


Executive system 
diagnostics 

Type of error 

Recovery technique 

••• Q(EC ERROR* •• 

Input stream edit phase 
errors 

Add or correct specific CS(CS*s) 


Insufficient dynamic 
storage area 

Increase job field length via external 
control card specification} increase 
run*s GOS area (controlled by initial* 
isation parameter LENGU via ANOPP CS 
or RSTRT C8 

DBM ERROR* •. 

Insufficient DUD space 

Increase OUD sits (controlled by initial* 
isation parameter NAEUD) via ANOPP CS 
or RSTRT CS 


Insufficient data table 
directory (DTD) space 

Increase dto siee (controlled by initial* 
isation parameter NAETD) via ANOPP CS or 
RSTRT CS 


Insufficient dynamic 
storage area 

Increase job field length via external 
control card specification} increase 
run 'a CDS area (controlled by initial- 
isation parameter lengl) via ANOPP CS 
or RSTRT CS 


Missing or erroneously 
identified run-llfe 
data base unit or 
member 

Add or correct C8*s and/or external con- 
trol card (a) that establish or specify 
the data base component 


Erroneous data found on 
specified unit or 
member 

Reexamine data requirements} Interrogate 
content of erroneous component via 
CATALOG CS, MEMLIST CS, or TA8L18T CS 
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Nauovury technique 
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Iserl on pereieater MAkiml wl« ANoeP rs 
nr RSIIIT ( h 

Ipi reeee Ii*h field ieitqlh vie eeteiMei 
omtrtil card ei»*rl f i«'el l«m 

RecherR data requt ) epenfst add Of 1 orrecf 
eppUi'ehle nii’N’el end/oi eRterna) con- 
tfol cardiel eateMlahinq u» epeclfylnq 
data romonantj verify rurreni run-Ufe 
data haae vU ‘’Ri verify at*»red 

, orttant of Ikhrary file via eeierate 
MiAii rNM'ATAl.««l **n aiHiuence, 

• 0*m MRor,,. 

Ittnurf li'Unt 

In* reaaa loh field Unqth vU eifernal 

••• «TH Flim»R.., 

mtotdqR Arm* 

TAm.R CH *rvl/or t*hV* 
vipRorlpf lt>n ortrd** 
iMiiim nmt nyntAN 
mirofN 

Brronmmifi t*Mm Idmn- 
tlfli'Atlon^ dRflnt* 
Mon, or oontmnt 

cttntrol card simrlf leal inni inrreaRe 
runU iinii aiea (controlled by Initial- 
i tat Ion paraieeter I.PIUU via AffoPR CH 
or RflTflT C!t 

I’oriect appll' ahU cs and/or directives 

Verify table requl resents of run or FHi 
verify content of table aesber via 
TARLIflT 0S| add or cm rect any I’H, 
directive, nr external control card 
estabUshlnq or deflnlnq tablet assis- 
tance of personnel sMlntalnlnq syaiee 
or functional nodule nay be required 

OSN BAROR..* 

Insufficient core or 
OnS'LDS over Up 

Othere 

Increase Job field lenqth via external 
ccntrol card specification 

Host PSH error dlaqnoatlcs were Intended 
to assist In aysten develofaent and 
debuqqlnqi contact AHi^PP syaten taaln- 
tenanre personnel for assistance 

UPPATR KRR13R... 

Tfte oAlsfllon of, or 
errors In, u(xUte 
neeber-level «nd 
record* level 
airective(s) 

Insufficient core 

Nleslnu or erroneously 
Identified run-life 
dat* units and sten- 
bere required in the 
u(k1ate proc^'ss 

Erroneous data found v.a 
aped fled unit or 
nenber 

Md or correct the UppATB and/or 

Sfieclflc dtrectlve<a> 

Increase lob field lenqth via external 
control card s|ieclf icatlon 

Add or correct the external control cards, 
C8*a, and U(x1ate directives that estab- 
lish or Identify the data ccn|>onents 

Reexanine data requlrenef'tn, Inter ri>qate 
content of erroneous conponents via 
CATALiKS CR, RRtt.lST 08, of TABLtST 08 

**• UTIUTY KRRvIR... 

Invalid or erroneous 
user paraneter or 
•ember data tyiie 
or values 

RechecH data requlrenents of the executed 
fNt asslstam'e frv« ANOPR syaten or PM 
nalntenance personnel nay be required 

BVAl.UATR 

Invalid or erroneous 
user iviraiaeter 

RechecR user parMietera 


The user la reminded that ANOPP checkpoint and restart processing 
capabilities allow for the debugging of large ANOPP applications without 
requiring reexecution of the entire run. XTRACR reports are printed as a 
result of all fatal and some nonfatal system errors. They are Intended to 
help In the debugging of Internal ANOPP system code and should be referenced 
when the user seeks the assistance of ANOPP system maintenance personnel. 
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APPENDIX D 

GUIDE TO ANOPP OPERATING SYSTEMS 
D.1 OVERVIEW 

This appendix presents the external control cards used to run an ANOPP 
job on a particular operating system. No attempt is made to fully document 
each control card; the user must either possess personal knowledge of the 
operating system or gain assistance from someone familiar with the operating 
system. In most cases reference manuals are available to provide complete 
documentation of the control cards presented. 


D.2 GUIDE FOR CONTROL DATA NETWORK OPERATING SYSTEM (NOS) 
D.2.1 The Basic ANOPP Job Deck 


The basic job deck used to run ANOPP on the Control Data NOS is pre- 
sented below. The card numbers (ccl, cc2, and so forth) are used to refer- 
ence the specific control cards in the discussion which follows. 

ccl J0BNAME,CM1 70000, T300. 

cc2 USER. 

cc3 ATTACH, ANOPP. 

cc4 RPL, 170000. 

cc5 REDUCE(-) 

cc6 ANOPP. 

cc7 7-8-9 (card-deck record-separator card) 

cc8 STARTCS $ 

I (other ANOPP control statements) 

•’C'? ENDCS $ 

ccIO S-7-8-9 (card-deck end-of-information card) 

ccl - The job statement is required as the first card in all NOS job 

decks. 

The CM parameter establishes the maximum central memory required 
to run the job. ANOPP runs normally execute within a CM field 
length of 170000 (octal) words. The largest run in the job 
dictates the CM value. The LDS and GDS requirements of a run 
often require an increase in this value. 

The T parameter establishes the maximum run time allowed for 
the job expressed in number (octal) of computer central pro- 
cessing seconds. 

cc2 - The USER card establishes a user's run permission. It may be a 

USER, ACCOUNT, or CHARGE card. Local site directives must be 
referenced to determine which is appropriate. 

cc3 - This ATTACH card establishes the job assignment of external pro- 

gram file ANOPP and must precede the execution of the first ANOPP 
run In the job. 
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APPENDIX P ^ . 

cc4 to cc6 - Ttiese three cards control a load and execution of ANOPP* 

Tlie RPL and REDUCE cards establish a central memory field 
length that will remain under the control of ANOPP during 
its execution. 

cc7 - Ihe record-separator card (7-8-9 multipunch in column 1) ^ 

separates the NOS control cards record (ccl to cc6) from the 
primary input stream (cc8 to cc9) required by the ANOPP run 
executed via card cc6. 

cc8 to cc9 - The user's primary input stream to the single ANOPP run 

in this job* f 

cc10 - Ihe end-of-information card (6-7-8-9 multipunch in column 1) 
required to terminate a NOS job deck* 


D*2*2 Additional NOS Control Cards 

Additional NOS control cards besides those included in the basic job 
deck are required when data base items residing on external files are 
involved* A job deck containing multiple ANOPP runs is presented below* 

The permanent and user's data base requirements reside on sequential tape 
and mass-storage files and on random-access mass-storage files* Hie second 
ANOPP run in the job creates a new library tape file and a new data unit 
residence file that is to be permanently retained on the mass-storage 
devices of the host system. 


ccl 

cc2 

cc3 

cc4 

cc5 

cc6 

cc7 

cc8 

cc9 

ccIO 

cell 

ccl 2 

cc1 3 

cc14 

ccl 5 

cc16 

ccl 7 

cc18 

ccl 9 

cc20 

cc21 

cc 22 

cc23 

cc24 

cc2B 

cc 28 

cc27 


NEWJOB,CM200000,T500* 

USER* 

ATTACH^ ANOPP. 

REQUEST (JETTAPE,VSN=NU9876, * * .etc ) 

ATTACH, JETUN1=AN0PF1 . 

RPL, 170000* 

REDUCE (-) 

ANOPP. 

RETURN, JETTAPE,JETUN1 * 

REQUEST (NEWT APE, VSN=NU987 7, . . .etc) 

DEFINE( JETUNIT, . . .etc) . 

RFL, 200000* 

REDUCE(-) 

ANOPP. 

UNLOAD, NEWTAPE. 

7-8-9 (card-deck record-separator card) 
STARTCS $ 

LOAD/JETTAPE/ UNIT2, UNIT3 $ 

ATTACH UNIT1/JETUNV $ 

CREATE PM3DATA/TKMP1/ $ 

EXECUTE PM2 $ 

7-8-9 (card-deck record-separator card) 
ANOPP LENGL^9000 $ 

STARTCS $ 

ATTACH FM3DATA/TEMP1/ $ 

CREATE MNIT7/JETUNIT/ $ 

EXECUTE FM3 $ 


3 

•j 

I 


i 

\ 

i 

i 

i 

'i 

i 

i 
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V.fTiT^v^f- 


cc28 

oc29 


appendix d 
UNLOAD/NEWTAPE/ $ 

e-7-8-9 (card-deck end-of-informatlon card) 


" sequential library tape file JETTAPB. 

ANopp“".ir<rrrcc?8)!^ ^ 

' loefl“f?^^"® permanent external file ANOPPI to the 

iill be LLiif i i ] T® resident data unit UNITI 

will be established in the first ANOPP run via card cc19. 


CC6 to CC8 - Loads and executes the first ANOPP run. An rpl (field 

foTS liput ^trea™ 

tor cnis run are cards ccl7 to cc21. 

“S" ?oT “• 

CC12 to CC14 - io« ,„4 , ^ 

tS tsriV^s'h®? ““> “• 

tor the job must be increased to 200000 octal words 

- r» — - - 

cc„ to CC2, - *%™/:H„t:r,r “ ““ 

OC20 ana 0025 - Hote^at no axtarnal NOS oontrol oara, ..tabu.n ana 

t..rr ^vzr^z:: t“* 


cc23 to cc28 


" ae°on<3 ANOPP run 

(executed by card ccl4) is entered. 
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SUMMARY OF ANOPP FUNCTIONAL MODULES FOR LEVEL 03/00/00 


Module 

name 

Module 

title 

Brief 

description 

(a\ 

Calling 

procedures 

ABS 

Atmospheric 

Absorption 

Module 

Computes atmospheric absorption 
coefficient as function of alti- 
tude and frequency using either 
ANSI or SAB method 

ATMDAT 

ATM 

Atmospheric 

Module 

Computes atmospheric properties as 
function of altitude using hydro- 
static model 

ATMDAT 

CNLJET 

Dual Stream 
Coannular Jet 
Noise Module 

Predicts noise for a double stream 
coannular jet with inverted velocity 
profile using Russell and Pao 
method 

DCNLJET 

TCNLJET 

EPF 

Effective 
Noise Nodule 

Computes EPNL 

PROMUL 

PROSGL 

PLI 

Flight Dyna- 
namics Module 

Compu'tes tvro— degree— of •freedom 
take-off for aircraft 


FNKAFM 

Airframe 
Noise Module 

Predicts noise for airframe using 
Fink method 

DFNKAFM 

’:”PNKAPM 

GECOR 

Combustion 
Noise Module 

Predicts noise for combustor using 
SAE method 

DGECOR 

TGECOR 

GENSUP 

General 

Suppression 

Module 

Applies noise suppression factor to 
a noise table produced by any noise 
source module 

SDLDIR 

GEO 

Geometry 

Module 

Calculates source-to-observer 
geometry 


GETUR 

Turbine 

Noise 

Module 

Predicts noise for turbine using 
GB method 

DGETUR 

TGETUR 

GRA 

Ground 
Reflection 
and Attenua- 
tion Module 

Computes ground effects factor 
using Chlen-Soroka theory (method 
is also directly computed in the 
Propagation Module) 



£1 

For more complete descriptions of the modules and the methods used, see 
reference 1 . 
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Module 

name 

Module 

title 

Brief 

description 

(a) 

Calling I 

procedures 1 

HDNPAN 

Fan Noise 
Module 

predicts noise for fan using the 
Heidman method 

DHDNFAN | 

THDNFAN I 

LEV 

Noise Levels 
Module 

Computes OASPL, A-weighted SPL, 
l>-weighted SPL, PNL, and PNLT 

PROMUL 

PROSGL 

PREAPM 

Airframe 
Noise Paraun- 
eters Module 

Generates noise prediction param- 
eters for airframe noise 

TFNKAPM 

PRECOR 

Core Noise 
Parameters 
Module 

Generates noise prediction param- 
eters for combustion noise 

TGECOR 

■ 

Fan Noise 

parameters 

Module 

Generates noise prediction param- 
eters for fan noise 

THDNFAN 


Jet Noise 

Parameters 

Module 

Generates noise prediction param- 
eters for jet noise 

TCNLJET 
TSAESHK 
TSGLJET 
rSTNJET I 

PRETim 

Turbine 
Noise Param- 
eters Module 

Generates noise prediction param- 
eters for turbine noise 

TGETUR 

TSMBTUR 

PRO 

Propagation 

Module 

Generates sound spectra at observer 
from source tables with applica- 
tion of atmospheric absorption and 
ground effects 

PROMUL 
PROSGL 1 

SAESHK 

Circular Jet 
Shock Cell 
Noise Nodule 

Predicts shock noise using SAE 
method 

DSAESHK 1 

TSAESHK 1 

SGLJET 

Single Stream 
Circular Jet 
Noise Module 

Predicts jet noise using SAE method 

DSGLJET 1 
TSGLJET 

SN6TUR 

Smith and 
Bushell 
Turbine Noise 
Module 

Predicts turbine noise using Smith 
and Bushell method 

DSMBTUR 

TSMBTUR 

STNJET 

Ston Jet 
Noise Module 

Predicts far-field mean-square 
acoustic pressure for single 
stream and coaxial circular jets 
using Stone method 

DSTNJET I 

TSTNJET 


For more complete descriptions of the modules snd the methods used, see 


reference 1 • 
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